发起宜搭审批流程
POST
/v1.0/yida/processes/instances/start最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口发起宜搭审批流程到钉钉开放平台。
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 宜搭流程数据写权限 | API Explorer |
第三方企业应用 | 支持 | 宜搭流程数据写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 宜搭流程数据写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter.methodInputs.invalidFormat | 数据格式错误:%s | 数据格式错误 |
400 | invalidParameter.form.bindingRelationNotExists | 页面与流程的关联关系不存在:%s | 页面与流程的关联关系不存在 |
400 | invalidParameter.number.exceed | 数字超过限制:%s | 数字超过限制 |
400 | invalidParameter.form.formUUIDOrProcessCodeIsEmpty | formUuid和processCode不能都为空:%s | formUuid和processCode不能都为空 |
400 | dataNotExist.form.notExists | 表单不存在:%s | 表单不存在 |
400 | invalidParameter.methodInputs.invalid | 入参校验失败:%s | 入参校验失败 |
500 | dataModified.form.formAlreadyModified | 实例数据已修改, 请刷新当前页面:%s | 实例数据已经修改 |
500 | unclassifiedError | 异常:%s | 通用异常信息 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
appType
string
应用编码。
systemToken
string
必需
应用秘钥。在应用数据中获取。
userId
string
必需
用户的userid。
language
string
语言,取值:
formUuid
string
表单唯一编码。
formDataJson
string
表单数据。
processCode
string
流程编码。
departmentId
string
可选
发起人所在部门ID。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
string
流程实例ID。
示例
{
"result": "string"
}
最后修改时间: 2 年前