Darwinbox 数据 API：休假、考勤与薪酬

Darwinbox Digital Solutions Pvt. Ltd. · 企业办公 4.6 ★

Darwinbox 是 Darwinbox Digital Solutions Pvt. Ltd. 面向在 Darwinbox 租户上运行人事栈的企业员工的官方 Android HR 客户端。工人选定公司子域后，用用户名加密码（或 OTP、二维码、SAML、验证器）登录，随后打卡、请假、查看 CTC 看板、下载工资单与 Form 16、申报福利与报销，并开具服务台工单。开发商位于印度特伦甘纳邦海德拉巴 Kavuri Hills Madhapur Road，Best Western Jubilee Ridge Hotel 对面 Plot No.17，邮编 500033；Play 上约 9.7 万条评价给出 4.6 分，下载量 100 万+。它是全套 HCM 应用而不是单一打卡钟，与 Workday、ADP Mobile Solutions、Paylocity、Dayforce 同属员工通勤打开的 HRIS。

休假行带有 leaveName，含 currentAvailableBalance、yearlyAllotment 与 taken。当月考勤卡片是 presentDays 对 lateBy、overtime 与 shiftName。薪酬落在 totalCTC 加 salaryStructureName；工资单文件以 label、generatedOn 与 pdfURL 为键。登录名片是 employee_code 加 ManagerNm 与 dateOfJoining。

接单机器人提交海德拉巴租户已经展示的同一 leave_id；工时任务把 lat/lng 打卡写进 ERP 花名册；薪酬归档把 pdfURL 与 totalCTC 放在一起——openData Studio 把这条 HCM 闭环变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

登录换取租户 token
POST /v1/darwinbox/session osint
用用户名加哈希密码换取后续 HR 请求使用的租户 token。
认证方式：无需登录。请求体为 username、哈希 password、UDID 与 enc=1。返回的 token 作为后续租户请求的 query token=。
- username
- password
- UDID
- enc
- token
- userId
- tenantId
- isManager
```
POST /v1/darwinbox/session HTTP/1.1
Content-Type: application/json

{
  "username": "anita.rao",
  "password": "sha256hash,sha256hash",
  "UDID": "device-9f3a",
  "enc": 1
}
```
```
{
  "token": "tkn-88c1",
  "userId": "u-44102",
  "tenantId": "acme.example.in",
  "isManager": false
}
```
请求 OTP
POST /v1/darwinbox/otp osint
向指定租户工人的 mobile_number 发送登录 OTP。
认证方式：无需登录。请求体为 tenant、mobile_number 与 ext。
- tenant
- mobile_number
- ext
- status
- message
```
POST /v1/darwinbox/otp HTTP/1.1
Content-Type: application/json

{
  "tenant": "acme",
  "mobile_number": "9908088103",
  "ext": "+91"
}
```
```
{
  "status": true,
  "message": "sent"
}
```

登录员工资料

GET /v1/darwinbox/me osint

返回登录 AppUser：employee_code、department、designation 与 ManagerNm。

认证方式： POST /v1/darwinbox/session 签发的 query token。

user_id
mongo_id
employee_code
firstname
lastname
email
department
designation
ManagerNm
dateOfJoining
office_location_name

GET /v1/darwinbox/me?token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "user_id": "u-44102",
  "mongo_id": "64f1a2b3",
  "employee_code": "EMP-1024",
  "firstname": "Anita",
  "lastname": "Rao",
  "email": "[email protected]",
  "department": "Finance",
  "designation": "Analyst",
  "ManagerNm": "Vikram Shah",
  "dateOfJoining": "2021-04-12",
  "office_location_name": "Hyderabad"
}

休假余额

GET /v1/darwinbox/leave opendata

分页休假类型行，含 currentAvailableBalance、yearlyAllotment 与 taken。

认证方式： POST /v1/darwinbox/session 签发的 query token。

user_id
items
leaveId
leaveName
currentAvailableBalance
yearlyAllotment
taken
accruedSoFarThisYear
isCompOff
isUnpaid

GET /v1/darwinbox/leave?user_id=u-44102&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "items": [{
    "leaveId": "L-12",
    "leaveName": "Privilege Leave",
    "currentAvailableBalance": "8.5",
    "yearlyAllotment": "18",
    "taken": "9.5",
    "accruedSoFarThisYear": "13.5",
    "isCompOff": false,
    "isUnpaid": false
  }]
}

申请休假

POST /v1/darwinbox/leave/apply opendata

提交 leave_id 在 from_date 与 to_date 之间的休假申请。

认证方式： POST /v1/darwinbox/session 签发的 query token。

leave_id
user_id
from_date
to_date
status
message

POST /v1/darwinbox/leave/apply?token=tkn-88c1 HTTP/1.1
Content-Type: application/json

{
  "leave_id": "L-12",
  "user_id": "u-44102",
  "from_date": "2026-10-14",
  "to_date": "2026-10-16"
}

{
  "status": true,
  "message": "submitted"
}

考勤汇总

GET /v1/darwinbox/attendance opendata

返回当月考勤卡片：presentDays、lateBy、overtime 与 shiftName。

认证方式： POST /v1/darwinbox/session 签发的 query token。

user_id
presentDays
absentDays
leaveDays
lateBy
overtime
totalWorkDuration
shiftName
policyName
clockInAllow
userMongoId

GET /v1/darwinbox/attendance?user_id=u-44102&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "presentDays": "18",
  "absentDays": "1",
  "leaveDays": "2",
  "lateBy": "00:24",
  "overtime": "04:10",
  "totalWorkDuration": "148:00",
  "shiftName": "General",
  "policyName": "HO-HYD",
  "clockInAllow": 1,
  "userMongoId": "64f1a2b3"
}

上班打卡
POST /v1/darwinbox/attendance/punch opendata
为登录用户写入一次打卡，可选带 lat/lng。
认证方式： POST /v1/darwinbox/session 签发的 query token。
- user_id
- lat
- lng
- status
- message
```
POST /v1/darwinbox/attendance/punch?token=tkn-88c1 HTTP/1.1
Content-Type: application/json

{
  "user_id": "u-44102",
  "lat": 17.4483,
  "lng": 78.3915
}
```
```
{
  "status": true,
  "message": "punched"
}
```

薪酬看板

GET /v1/darwinbox/pay openfinance

返回薪酬看板：totalCTC、salaryStructureName 与 financialYear。

认证方式： POST /v1/darwinbox/session 签发的 query token。

year
currency
financialYear
totalCTC
salaryStructureName
effectiveFrom
isFlexiOpen
displayPackage

GET /v1/darwinbox/pay?year=2026&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "currency": "INR",
  "financialYear": "2026-27",
  "totalCTC": "1800000",
  "salaryStructureName": "HO Analyst",
  "effectiveFrom": "2026-04-01",
  "isFlexiOpen": true,
  "displayPackage": true
}

列出工资单

GET /v1/darwinbox/payslips openfinance

按 label 分页工资单，含 generatedOn 与 pdfName。

认证方式： POST /v1/darwinbox/session 签发的 query token。

year
items
label
generatedOn
pdfName
isDownload

GET /v1/darwinbox/payslips?year=2026&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "items": [{
    "label": "Sep 2026",
    "generatedOn": "2026-10-01",
    "pdfName": "payslip-2026-09.pdf",
    "isDownload": true
  }]
}

下载工资单

GET /v1/darwinbox/payslips/{month} openfinance

返回单月工资单的 pdfURL。

认证方式： POST /v1/darwinbox/session 签发的 query token。

user_id
month
pdfURL
pdfName

GET /v1/darwinbox/payslips/2026-09?user_id=u-44102&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "pdfURL": "https://files.example/payslip-2026-09.pdf",
  "pdfName": "payslip-2026-09.pdf"
}

列出福利
GET /v1/darwinbox/benefits openfinance
分页福利行，含 label、value 与 totalAccrued。
认证方式： POST /v1/darwinbox/session 签发的 query token。
- items
- id
- label
- value
- totalAccrued
- declarationByUser
```
GET /v1/darwinbox/benefits?token=tkn-88c1 HTTP/1.1
Accept: application/json
```
```
{
  "items": [{
    "id": "B-4",
    "label": "LTA",
    "value": "12500",
    "totalAccrued": "37500",
    "declarationByUser": true
  }]
}
```

假日日历

GET /v1/darwinbox/holidays opendata

返回租户 year 的假日日历。

认证方式： POST /v1/darwinbox/session 签发的 query token。

user_id
year
items
date
name

GET /v1/darwinbox/holidays?user_id=u-44102&year=2026&token=tkn-88c1 HTTP/1.1
Accept: application/json

{
  "year": "2026",
  "items": [{
    "date": "2026-10-02",
    "name": "Gandhi Jayanti"
  }]
}

租户设置

GET /v1/darwinbox/tenant opendata

解析公司子域的租户品牌与 MFA 开关。

认证方式：无需登录。登录前解析公司子域。

host
tenantName
logoUrl
authenticatorEnabled
mobileMfaEnabled

GET /v1/darwinbox/tenant?host=acme.example.in HTTP/1.1
Accept: application/json

{
  "tenantName": "acme.example.in",
  "logoUrl": "https://cdn.example/acme.png",
  "authenticatorEnabled": true,
  "mobileMfaEnabled": false
}

数据类别

员工资料
休假余额
考勤
薪酬
工资单
福利
假日
登录会话

数据使用场景与案例

劳动力机器人休假叠加
助手轮询 GET /v1/darwinbox/leave（currentAvailableBalance、yearlyAllotment）再 POST /v1/darwinbox/leave/apply，让经理机器人无需打开应用即可提交 Privilege Leave。
考勤进 ERP 打卡日志
工时任务读取 GET /v1/darwinbox/attendance（presentDays、lateBy、overtime、shiftName）并 POST /v1/darwinbox/attendance/punch，让每次打卡落在 ERP 花名册旁。
CTC 与工资单归档
薪酬归档把 GET /v1/darwinbox/pay（totalCTC、salaryStructureName）与 GET /v1/darwinbox/payslips（label、generatedOn）以及 GET /v1/darwinbox/payslips/{month}（pdfURL）接在一起。
福利加假日日历
人事看板把 GET /v1/darwinbox/benefits（label、totalAccrued）与 GET /v1/darwinbox/holidays 并列，让 LTA 申报挨着租户日历。

常见问题

Darwinbox 如何认证 API 调用？

POST /v1/darwinbox/session 用 username 加哈希 password、UDID 与 enc=1 换取 token、userId 与 tenantId。POST /v1/darwinbox/otp 可先发手机 OTP。之后的请求把该 token 作为 query 参数传递。

哪些端点暴露休假、考勤与薪酬？

GET /v1/darwinbox/leave 返回 currentAvailableBalance 与 yearlyAllotment。POST /v1/darwinbox/leave/apply 提交申请。GET /v1/darwinbox/attendance 返回 presentDays、lateBy 与 shiftName。GET /v1/darwinbox/pay 返回 totalCTC。GET /v1/darwinbox/payslips 列出 label 与 generatedOn。

返回哪些员工资料字段？

GET /v1/darwinbox/me 返回 user_id、mongo_id、employee_code、firstname、lastname、email、department、designation、ManagerNm、dateOfJoining 与 office_location_name。

API 是否覆盖福利与假日？

覆盖。GET /v1/darwinbox/benefits 返回 label、value 与 totalAccrued。GET /v1/darwinbox/holidays 返回租户某年日历。GET /v1/darwinbox/tenant 在登录前解析品牌与 MFA 开关。

与 Darwinbox 相似的应用

Workday — Workday 是美系 HCM 套件（工时、缺勤、薪酬）；Darwinbox 是印度自研对照，员工用它处理休假、打卡与 CTC。
ADP Mobile Solutions — ADP Mobile Solutions 是美系薪酬与工时客户端；Darwinbox 为 Darwinbox 租户覆盖同一套打卡、休假与工资单闭环。
Paylocity — Paylocity 是美国中端 HCM 应用（打卡与发薪）；Darwinbox 是海德拉巴运营、印度企业发给员工的套件。
Dayforce — Dayforce（Ceridian）是面向发薪与排班的劳动力管理客户端；Darwinbox 则以租户休假、CTC 与 Form 16 为中心。
BambooHR — BambooHR 是面向小团队的轻量美系 HRIS；Darwinbox 是印度企业从考勤到薪酬选用的全套租户。
Keka HR — Keka 是另一款印度自研 HRMS（休假、考勤、薪酬），与 Darwinbox 在海德拉巴市场的员工端重叠。
Zoho People — Zoho People 是 Zoho 的 HR 模块；Darwinbox 是带打卡、CTC 看板与 Form 16 下载的专用 HCM 租户。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Darwinbox 数据 API：休假、考勤与薪酬

应用截图

API 端点一览

登录换取租户 token

请求 OTP

登录员工资料

休假余额

申请休假

考勤汇总

上班打卡

薪酬看板

列出工资单

下载工资单

列出福利

假日日历

租户设置

数据类别

数据使用场景与案例

劳动力机器人休假叠加

考勤进 ERP 打卡日志

CTC 与工资单归档

福利加假日日历

常见问题

与 Darwinbox 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Dayforce

相关主题

需要集成这个 App 的数据 API？

Darwinbox 数据 API：休假、考勤与薪酬

应用截图

API 端点一览

登录换取租户 token

请求 OTP

登录员工资料

休假余额

申请休假

考勤汇总

上班打卡

薪酬看板

列出工资单

下载工资单

列出福利

假日日历

租户设置

数据类别

数据使用场景与案例

劳动力机器人休假叠加

考勤进 ERP 打卡日志

CTC 与工资单归档

福利加假日日历

常见问题

相关应用

与 Darwinbox 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Dayforce

相关主题

需要集成这个 App 的数据 API？