获取签署人签署地址

POST

/v2.0/esign/process/executeUrls

调用本接口获取到签署地址，isv应用内用户可点击进入签署页面进行签署，区分钉钉容器内的地址和钉钉容器外的地址（浏览器）。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	E签宝数据管理权限	API Explorer
第三方企业应用	支持	E签宝数据管理权限	API Explorer
第三方个人应用	暂不支持	E签宝数据管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	requestParamError	%s	请求参数错误
400	getFlowInfoError	获取流程信息失败	获取流程信息失败
400	queryFlowError	查询流程详情异常	查询流程详情异常
400	getUserInfoFail	获取用户信息失败,%s，%s	获取用户信息失败
400	getSignUrlError	获取签署链接失败: %s	获取签署链接失败

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v2.0/esign/process/executeUrls' \
--header 'serviceGroup;' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "taskId" : "PRO-289F96A1xxx",
  "signContainer" : 1,
  "account" : "188xxx"
}'

响应示例

{
  "mobileUrl" : "http://xxx.com",
  "pcUrl" : "http://xxx.com",
  "longUrl" : "http://www.xxx.com",
  "shortUrl" : "http://www.xxx.com"
}

修改于 2024-01-25 02:30:56

创建签署流程

获取流程的签署详情

获取签署人签署地址

权限#

错误码#

请求参数

返回响应

权限

错误码