流程签署人列表
接口地址 /v1/signflows/{flowId}/signers
请求方式 GET
接口描述 查询流程所有签署人列表。
请求参数
| 参数名称 | 说明 | 参数类型 | 必填 | 类型 |
|---|---|---|---|---|
| flowId | 流程id | path | true | string |
请求示例
GET https://openapi.esign.cn/v1/signflows/{flowId}/signers
响应参数
| 参数名称 | 说明 | 类型 | ||
|---|---|---|---|---|
| signers | 签字人列表 | array | ||
| signOrder | 签署顺序 | int32 | ||
| signStatus | 签署状态, 0-待签, 1-未签, 2-已签 3-待审批 4-拒签 | int32 | ||
| signerAccountId | 签署人账号id | string | ||
| signerName | 签署人名称 | string | ||
| signerRealName | 签署人是否已实名 | boolean | ||
| signerAuthorizedAccountId | 签约主体的账号id（个人/企业）；如签署人本签署，则返回签署人账号id；如签署人代机构签署，则返回机构账号id | string | ||
| signerAuthorizedAccountName | 签约主体名称 | string | ||
| signerAuthorizedAccountRealName | 签署主体是否已实名 | boolean | ||
| signerAuthorizedAccountType | 签署主体类型, 0-个人, 1-机构 | int32 | ||
| thirdOrderNo | 本次签署任务对应指定的第三方业务流水号id，当存在多个第三方业务流水号id时，返回多个，并逗号隔开 | true | string |
响应示例
{
"code":0,
"data":{
"signers":[
{
"signOrder":1,
"signStatus":1,
"signerAccountId":"24c93459216945468fdf1d899c521910",
"signerAuthorizedAccountId":"2c7de24aff3340f5b944ebac49545b8e",
"signerAuthorizedAccountName":"深圳天谷信息科技有限公司",
"signerAuthorizedAccountRealName":true,
"signerAuthorizedAccountType":1,
"signerName":"孙中山",
"signerRealName":true
}
]
},
"message":"成功"
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 1437105 | 流程已删除 | 已经删除的流程不能查看签署人列表 |