获取审计协议签署人员信息
更新于 2023-01-18本接口用于获取审计应用内已签署和未签署人员的信息,包括人员的姓名,userId,手机号,部门等信息。
例如,审计应用内查看的条款签署情况为
-
已签署:3人。
-
未签署:79人。
调用本接口可以获取到已签署和未签署员工的信息,如下图所示。

权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 专属钉钉审计读权限 | API Explorer |
第三方企业应用 | 支持 | 专属钉钉审计读权限 | API Explorer |
第三方个人应用 | 暂不支持 | 专属钉钉审计读权限 | 暂不支持 |
请求方法
Loading...
Header参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Query参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
pageNumber | Long | 是 | 页码,首次传1。 |
signStatus | Long | 是 | 签署状态。
|
pageSize | Long | 是 | 每页数量,最大值2000。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
auditSignedDetailDTOList | Array | 员工信息 |
name | String | 员工名称。 |
staffId | String | 员工userId。 |
title | String | 职位。 |
phone | String | 员工手机号。 |
String | 邮件。 | |
deptName | String | 部门名称。 |
roles | String | 角色名称。 |
currentPage | Long | 当前页码。 |
pageSize | Long | 当前页数据量。 |
total | Long | 总数据量。 |
示例
请求示例
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
返回示例
Loading...
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | param.missing | 参数不能为空 | 参数不能为空 |
500 | system.busy | 系统繁忙,请稍后再试 | 系统繁忙 |