对外接口-创建任务单
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateTaskOrder |
系统规定参数。取值:CreateTaskOrder。 |
ProductTypeName | String | 否 | 云服务器 ECS-ECS |
问题分类名称 |
CustomerUserId | String | 否 | 123 |
建单人:固定值 |
CustomerRealName | String | 否 | 小二 |
建单人姓名:快手客户 |
TaskTitle | String | 是 | 建单标题 |
taskTitle |
ProductType | String | 是 | 3270 |
productType |
openconversitionid(String) //主群的ID 和departmentId传一个即可
departmentId(String) //建单传对应的主群id(上线前有固定的主群配置)
{ "departmentId": 47742592,//建单传对应的主群id(上线前有固定的主群配置) "createType": "cusSelf", "importantDesc": "",//isImportent 为hurry时需要填写原因说明 "createSource": "CUS_QUICK", "isImportent": "normal",//是否紧急normal或者hurry "requestId": "123",//每一次接口调用动态ID "productTypeName": "",//问题分类名称 "customerUserId": "",//无对应的钉钉号不传 "customerRealName": "王龙",//建单人姓名 "taskTitle": "测试快手API建单16点32", "class": "com.aliyun.dingtalklanding.pop.dto.ddtask.CreateTaskInfoReq", "productType": "3270" }
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Message | String | ok |
msg |
RequestId | String | 123 |
requestId |
Data | String | E21111796147LE |
返回任务单号:OrderId |
Code | String | 200 |
code |
Success | Boolean | true |
success |
返回结果data 为任务单ID,后续其他接口操作也会用到
示例
请求示例
http(s)://[Endpoint]/?Action=CreateTaskOrder
&OpenGroupId=cid+lUpHxTIXt7DYqJDcpVxlA==
&ImportantDescription=重要性说明原因
&IsImportant=normal或者hurry
&ProductTypeName=云服务器 ECS-ECS
&CustomerUserId=null
&CustomerRealName=小二
&TaskTitle=建单标题
&ProductType=3270
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateTaskOrderResponse>
<Message>ok</Message>
<RequestId>请求的UUID值</RequestId>
<Data>E21111796147LE</Data>
<Code>200</Code>
<Success>true</Success>
</CreateTaskOrderResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "ok",
"RequestId" : "请求的UUID值",
"Data" : "E21111796147LE",
"Code" : "200",
"Success" : true
}
错误码
访问错误中心查看更多错误码。