下载

Workhuman认可与奖励API架构指南

v20260423

workhuman-reference-architecture

本指南提供了Workhuman社交认可和奖励API的参考架构。它详细介绍了OAuth 2.0、点对点认可和可配置奖项等关键概念。当需要构建复杂的员工认可工作流、实现与HRIS系统（如Workday、SAP）的双向同步，或与Slack、Teams等协作工具集成时，应使用本技能。

Workhuman HR 认可奖励 API 集成 SaaS HRIS

417 次下载

概览

Workhuman Reference Architecture

Overview

Guidance for reference architecture with Workhuman Social Recognition and rewards API.

Instructions

Key Workhuman API Concepts

Auth: OAuth 2.0 client credentials flow
Recognition: Peer-to-peer and manager nominations with points
Awards: Configurable levels (bronze, silver, gold, platinum)
Values: Company values attached to recognitions
HRIS Sync: Bidirectional sync with Workday, SAP SuccessFactors
Integrations: Microsoft Teams, Slack, Outlook native plugins

Core API Endpoints

Endpoint	Method	Description
`/api/v1/recognitions`	GET	List recognitions
`/api/v1/recognitions`	POST	Create nomination
`/api/v1/recognitions/:id`	GET	Get recognition status
`/api/v1/users`	GET	List employees
`/api/v1/rewards/catalog`	GET	Browse reward catalog
`/api/v1/rewards/redeem`	POST	Redeem points for reward

Error Handling

Error	Cause	Solution
`401 Unauthorized`	Token expired	Re-authenticate
`403 Forbidden`	Insufficient permissions	Check role/permissions
`422 Validation`	Missing fields	Check required fields
`404 Not Found`	Invalid ID	Verify resource exists

Resources

Next Steps

See related Workhuman skills for more patterns.

信息

Category 编程开发

Name workhuman-reference-architecture

版本 v20260423

大小 1.98KB

Source jeremylongshore/claude-code-plugins-plus-skills

更新时间 2026-04-28

语言