核心用法
Zoho People Skill 是 Maton 平台提供的托管式 API 代理服务，允许开发者通过统一的 RESTful 接口访问 Zoho People 的核心人力资源功能。该 Skill 采用代理架构，请求发送至 api.maton.ai 后由平台自动注入 OAuth Token 并转发至 Zoho 官方 API。
主要能力覆盖
- 员工管理：获取员工列表（支持分页、按ID/邮箱搜索）、查看详情
- 组织架构：部门（department）与职位（designation）的 CRUD 操作
- 考勤请假：读取考勤记录、提交请假申请（需额外 OAuth 授权范围）
- 自定义表单：支持访问账户内的所有自定义表单数据
认证机制
采用双 Token 架构：用户持有 Maton API Key（通过 Authorization: Bearer 头部传递），Maton 后端托管 Zoho OAuth 2.0 Token。支持多连接管理，可通过 Maton-Connection 头部指定目标账户。
显著优点
1. 零 OAuth 开发成本：开发者无需处理 Zoho 的授权码流程、Token 刷新和存储
2. 多租户友好：单一 Maton 账户可管理多个 Zoho People 组织的连接
3. 完整 CRUD 覆盖：不仅支持查询，还封装了 insertRecord/updateRecord 等写操作
4. 标准 HTTP 接口：返回 JSON 格式，支持 curl、Python、JavaScript 等任意 HTTP 客户端
潜在缺点与局限性
- 供应商锁定：HR 数据流经 Maton 代理层，存在单点故障和额外网络延迟
- 写操作需人工确认：文档明确要求所有创建/更新/删除操作执行前必须获得用户显式批准，自动化场景受限
- 分页限制：单次最多返回 200 条记录，大数据集需手动处理分页逻辑
- OAuth 范围限制：考勤和请假等敏感操作需要额外授权，错误码
INVALID_OAUTHSCOPE需联系客服开通
适合人群
- 中小型企业 IT 管理员：需要快速同步 HR 数据到内部系统，无精力维护 OAuth 基础设施
- HR SaaS 集成开发者：构建与 Zoho People 双向数据同步的第三方应用
- 数据分析师：通过 Python/JS 脚本批量导出员工、考勤数据用于报表分析
常规风险
- 数据隐私：员工 PII（姓名、邮箱、出生日期等）流经第三方代理，需评估 Maton 平台的合规性承诺
- 操作误删：更新/删除接口无回收站机制，错误的
recordId可能导致数据不可逆丢失 - Token 泄露：MATON_API_KEY 泄露将导致所有托管连接的数据访问权限暴露，需严格保管环境变量