解锁/锁定发薪活动

开发中

生产环境

https://app91651.eapps.dingtalkcloud.com

POST

/hades/open/api/v1/payingactivity/lockStatus

scope:hades:payingactivity:lockStatus

接口作用

锁定或解锁发薪活动，接口是幂等的。锁定要求发薪活动已计算完成。已锁定时再锁定、未锁定时再解锁均直接返回成功。

接口信息

属性	值
URL	`/open/api/v1/payingactivity/lockStatus`
Method	POST
Content-Type	application/json
权限标识	`hades:payingactivity:lockStatus`

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
payingActivityId	String	是	发薪活动ID
action	String	是	操作类型：lock-锁定，unlock-解锁

请求示例:

{
  "corpId": "corp_123456",
  "payingActivityId": "pa_001",
  "action": "lock"
}

返回参数

参数名	类型	说明
code	Integer	状态码，0表示成功
msg	String	返回消息
data	Boolean	true表示操作成功

返回示例:

{
  "code": 0,
  "msg": "success",
  "data": true
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "payingActivityId": "act404a7add0b564d83929dcbcdea52f7bd",
  "action": "unlock"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app91651.eapps.dingtalkcloud.com/hades/open/api/v1/payingactivity/lockStatus' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
  "payingActivityId": "act404a7add0b564d83929dcbcdea52f7bd",
  "action": "unlock"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data": true,
	"rid": "f2eb4a268b09400380cb350fc9222a38",
	"success": true
}

修改于 2026-03-04 05:48:07

获取人员范围

批量创建发薪活动

解锁/锁定发薪活动

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数