对外接口-创建任务单

调试

您可以在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
}

错误码

访问错误中心查看更多错误码。