流程签署人列表
接口地址 /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 | 流程已删除 | 已经删除的流程不能查看签署人列表 |