阿里大于 -

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
sp_code	String	必须	test		服务商唯一编码
ticket_id	Number	必须	23762		工单Id

名称	类型	示例值	描述
result	Result		返回结果
└ error_desc String 系统错误错误描述 data Data 结果数据 └ customer_address String 浙江省杭州市余杭区余杭街道18221711953 客户地址 images Images [] 图片列表 └ type String spSendProof 图片类型：service-上门服务图片;cuSendProof-客户邮寄凭证;spSendProof-服务商邮寄凭证;abnormalImage-异常信息;purchaseVoucher-用户购买凭证 └ url String https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581592197843&di=f9c87d971517b5974193f3ef9f5c48e5&imgtype=0&src=http%3A%2F%2Fcms-bucket.nosdn.127.net%2F2018%2F10%2F25%2Fa06f2e0830bf4f84a52ce4a055c67238.jpeg%3FimageView%26thumbnail%3D750x0 图片url └ event_type_desc String 测试取件箱门不开事件类型描述 └ gmt_create Date 1589268569000 创建时间 └ customer_mail_no String ZT2487429472 客户寄回设备邮编 maintenance_info MaintenanceInfo 维修方案信息 └ maintain_method String replacement 维修方式 └ maintain_abilities String ONSITE 修理方式 └ pay_method String payBefore 支付方式：payBefore-维修前付费;payAfter-维修后付费;noNeedPay-无需付费 └ other_fee String 100.00 其它费用 └ fee_remark String 维修费用费用描述 part_item_list PartItemList [] 维修配件信息 └ item_code String 155 配件编码 └ pay_role String merchant 支付角色：merchant-商家记账；customer-客户付费 └ warranty_type String out_of_warranty 承保类型 └ event_type_list String [] 353 事件类型列表 └ customer_name String 张三客户名称 └ device_bar_code String dkegi6mi4348g4 设备bar code └ device_purchase_date String 2019-11-11 购买日期 └ customer_phone String 18221711953 客户联系方式 operate_log_list OperateLogList [] 操作记录 └ operate_phone String 18221711111 操作人联系方式 └ operate_time Date 1589268570000 操作时间 └ operate_type String 服务商受理操作类型描述 └ operate_name String 张龙操作人 └ remark String 请快点修好，并邮寄回来备注信息 └ ticket_description String 故障-故障，高拍仪照片留底不清晰，屏幕闪屏。工单详情描述 └ sp_mail_no String ST9247842744 服务商设备寄回邮寄编号 repairman_info RepairmanInfo 上门人员信息 └ repairman_id String 545643 上门维修人员编号 └ repairman_name String 赵五上门维修人员名称 └ repairman_phone String 1822222222 上门维修人员联系方式 └ appoint_date String 2020-02-02 16:40 上门时间 └ visit_address String 浙江省西湖区西溪首座b-1 上门维修地址 └ ticket_id Number 556 工单Id └ status_desc String 维修服务中服务状态描述：待受理；待发起维修方案；待确认维修方案；维修服务中；待确认完成；待评价；已完结；已撤销 └ success Boolean true 是否成功 └ error_code String SYSTEM_ERROR 错误码

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoIotTicketDetailQueryRequest req = new CainiaoIotTicketDetailQueryRequest();
req.setSpCode("test");
req.setTicketId(23762L);
CainiaoIotTicketDetailQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
CainiaoIotTicketDetailQueryRequest req = new CainiaoIotTicketDetailQueryRequest();
req.SpCode = "test";
req.TicketId = 23762L;
CainiaoIotTicketDetailQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new CainiaoIotTicketDetailQueryRequest;
$req->setSpCode("test");
$req->setTicketId("23762");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=cainiao.iot.ticket.detail.query' \
-d 'partner_id=apidoc' \
-d 'sign=4D7FB9CC21885F80E167849DBD123E89' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-05-01+00%3A09%3A05' \
-d 'v=2.0' \
-d 'sp_code=test' \
-d 'ticket_id=23762'

# -*- coding: utf-8 -*-
import top.api

req=top.api.CainiaoIotTicketDetailQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.sp_code="test"
req.ticket_id=23762
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"cainiao.iot.ticket.detail.query");
add_param(pRequest,"sp_code","test");
add_param(pRequest,"ticket_id","23762");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('cainiao.iot.ticket.detail.query', {
	'sp_code':'test',
	'ticket_id':'23762'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<cainiao_iot_ticket_detail_query_response>
    <result>
        <error_desc>系统错误</error_desc>
        <data>
            <customer_address>浙江省杭州市余杭区余杭街道18221711953</customer_address>
            <images>
                <images>
                    <type>spSendProof</type>
                    <url>https://timgsa.baidu.com/timg?image&amp;quality=80&amp;size=b9999_10000&amp;sec=1581592197843&amp;di=f9c87d971517b5974193f3ef9f5c48e5&amp;imgtype=0&amp;src=http%3A%2F%2Fcms-bucket.nosdn.127.net%2F2018%2F10%2F25%2Fa06f2e0830bf4f84a52ce4a055c67238.jpeg%3FimageView%26thumbnail%3D750x0</url>
                </images>
            </images>
            <event_type_desc>测试取件箱门不开</event_type_desc>
            <gmt_create>1589268569000</gmt_create>
            <customer_mail_no>ZT2487429472</customer_mail_no>
            <maintenance_info>
                <maintain_method>replacement</maintain_method>
                <maintain_abilities>ONSITE</maintain_abilities>
                <pay_method>payBefore</pay_method>
                <other_fee>100.00</other_fee>
                <fee_remark>维修费用</fee_remark>
                <part_item_list>
                    <part_item_list>
                        <item_code>155</item_code>
                        <pay_role>merchant</pay_role>
                    </part_item_list>
                </part_item_list>
                <warranty_type>out_of_warranty</warranty_type>
                <event_type_list>
                    <string>353</string>
                </event_type_list>
            </maintenance_info>
            <customer_name>张三</customer_name>
            <device_bar_code>dkegi6mi4348g4</device_bar_code>
            <device_purchase_date>2019-11-11</device_purchase_date>
            <customer_phone>18221711953</customer_phone>
            <operate_log_list>
                <operate_log_list>
                    <operate_phone>18221711111</operate_phone>
                    <operate_time>1589268570000</operate_time>
                    <operate_type>服务商受理</operate_type>
                    <operate_name>张龙</operate_name>
                    <remark>请快点修好，并邮寄回来</remark>
                </operate_log_list>
            </operate_log_list>
            <ticket_description>故障-故障，高拍仪照片留底不清晰，屏幕闪屏。</ticket_description>
            <sp_mail_no>ST9247842744</sp_mail_no>
            <repairman_info>
                <repairman_id>545643</repairman_id>
                <repairman_name>赵五</repairman_name>
                <repairman_phone>1822222222</repairman_phone>
                <appoint_date>2020-02-02 16:40</appoint_date>
                <visit_address>浙江省西湖区西溪首座b-1</visit_address>
            </repairman_info>
            <ticket_id>556</ticket_id>
            <status_desc>维修服务中</status_desc>
        </data>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
    </result>
</cainiao_iot_ticket_detail_query_response>

{
    "cainiao_iot_ticket_detail_query_response":{
        "result":{
            "error_desc":"系统错误",
            "data":{
                "customer_address":"浙江省杭州市余杭区余杭街道18221711953",
                "images":{
                    "images":[
                        {
                            "type":"spSendProof",
                            "url":"https:\/\/timgsa.baidu.com\/timg?image&quality=80&size=b9999_10000&sec=1581592197843&di=f9c87d971517b5974193f3ef9f5c48e5&imgtype=0&src=http%3A%2F%2Fcms-bucket.nosdn.127.net%2F2018%2F10%2F25%2Fa06f2e0830bf4f84a52ce4a055c67238.jpeg%3FimageView%26thumbnail%3D750x0"
                        }
                    ]
                },
                "event_type_desc":"测试取件箱门不开",
                "gmt_create":"1589268569000",
                "customer_mail_no":"ZT2487429472",
                "maintenance_info":{
                    "maintain_method":"replacement",
                    "maintain_abilities":"ONSITE",
                    "pay_method":"payBefore",
                    "other_fee":"100.00",
                    "fee_remark":"维修费用",
                    "part_item_list":{
                        "part_item_list":[
                            {
                                "item_code":"155",
                                "pay_role":"merchant"
                            }
                        ]
                    },
                    "warranty_type":"out_of_warranty",
                    "event_type_list":{
                        "string":[
                            "353"
                        ]
                    }
                },
                "customer_name":"张三",
                "device_bar_code":"dkegi6mi4348g4",
                "device_purchase_date":"2019-11-11",
                "customer_phone":"18221711953",
                "operate_log_list":{
                    "operate_log_list":[
                        {
                            "operate_phone":"18221711111",
                            "operate_time":"1589268570000",
                            "operate_type":"服务商受理",
                            "operate_name":"张龙",
                            "remark":"请快点修好，并邮寄回来"
                        }
                    ]
                },
                "ticket_description":"故障-故障，高拍仪照片留底不清晰，屏幕闪屏。",
                "sp_mail_no":"ST9247842744",
                "repairman_info":{
                    "repairman_id":"545643",
                    "repairman_name":"赵五",
                    "repairman_phone":"1822222222",
                    "appoint_date":"2020-02-02 16:40",
                    "visit_address":"浙江省西湖区西溪首座b-1"
                },
                "ticket_id":556,
                "status_desc":"维修服务中"
            },
            "success":true,
            "error_code":"SYSTEM_ERROR"
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

IoT售后解决方案API

cainiao.iot.ticket.detail.query (IoT售后工单详情查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ