API文档

连接和使用 Shifton API

Shifton API 让您可以访问平台的所有关键功能 —— 从排班管理到与外部 人力资源, 工资、分析系统的集成。.
通过使用 API，您可以自动化流程并将 Shifton 与贵公司的内部服务连接起来。

API 文档

我们支持两个版本的文档：

• 📄 旧版文档 —— API 参考的上一个版本（仍支持现有集成）：
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 新版文档 —— API 的当前版本，具有更新的结构和最新的方法：
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

入门指南

获取 API 密钥

在 Shifton 平台的公司设置中生成一个 API 密钥。.
授权通过请求头进行：

发起您的第一个请求

例如，要获取员工名单：

示例响应：

将 API 集成到您的工作流程中

• 自动创建和修改班次

• 管理休假和病假请求

• 将数据导出到工资系统

• 构建自定义仪表板和报告

核心 API 功能

• 员工 – 添加、编辑和管理角色

• 排班表 – 创建、调整班次、规划工作

• 请假与缺勤 – 管理假期和病假申请

• 报告 – 导出时间、工资和出勤数据

错误代码

Shifton API使用标准的HTTP状态代码:

• 200 — 请求成功

• 201 — 对象创建成功

• 400 — 参数无效

• 401 — 授权错误（API密钥无效）

• 403 — 拒绝访问

• 404 — 资源未找到

• 500 — 服务器错误

使用提示

• 始终使用新API版本用于新集成

• 使用 Postman 或 curl 进行测试

• 遵守 速率限制 以避免被封锁

• 更新仍依赖旧文档的集成