淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	描述
source	String	可选	tmall	来源
biz_type	String	可选	WuChangRice	业务
code	String	可选	0149CF1E3A3A4655B1	码
cipher	String	可选	123456	暗码
scan_user_info	ScanUserInfo	可选		用户信息
└ user_numb_id Number 可选 123 id └ user_nick String 可选 test name └ longitude String 可选 11.1 lo └ latitude String 可选 22.3 la └ tracecode String 可选 123456 ma

名称	类型	示例值	描述
result	DataResult		result
data TraceScanPageDetailMiniProgramDo obj user_scan_info UserScanInfoDo 溯源扫码信息 └ scan_count Number 1 扫码次数 └ first_scan_time String 2018-09-26 首次扫码时间 trace_details TraceDetails [] 溯源详情 └ title String 生产信息标题 blockchain Blockchain 溯源区块链信息 └ tx_hash String asdadsdasda 区块链txHash └ item_hash String asdadasdasd 区块链itemHash └ biz_type String WuChangRice bizType └ source String tmall source └ chain_version String 0.6 区块链版本 items Items [] items └ type String text 类型 └ title String 生产时间标题 └ desc String 2018-09-26 内容 └ ext_info String {"cover":"default-url"} 额外信息 └ code String code └ msg String msg └ success Boolean false success

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallTraceplatformInnerBlockchainTracedetailRequest req = new TmallTraceplatformInnerBlockchainTracedetailRequest();
req.setSource("tmall");
req.setBizType("WuChangRice");
req.setCode("0149CF1E3A3A4655B1");
req.setCipher("123456");
TmallTraceplatformInnerBlockchainTracedetailRequest.ScanUserInfo obj1 = new TmallTraceplatformInnerBlockchainTracedetailRequest.ScanUserInfo();
obj1.setUserNumbId(123L);
obj1.setUserNick("test");
obj1.setLongitude("11.1");
obj1.setLatitude("22.3");
obj1.setTracecode("123456");
req.setScanUserInfo(obj1);
TmallTraceplatformInnerBlockchainTracedetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

XML示例
JSON示例

<tmall_traceplatform_inner_blockchain_tracedetail_response>
    <result>
        <data>
            <user_scan_info>
                <scan_count>1</scan_count>
                <first_scan_time>2018-09-26</first_scan_time>
            </user_scan_info>
            <trace_details>
                <trace_details>
                    <title>生产信息</title>
                    <blockchain>
                        <tx_hash>asdadsdasda</tx_hash>
                        <item_hash>asdadasdasd</item_hash>
                        <biz_type>WuChangRice</biz_type>
                        <source>tmall</source>
                        <chain_version>0.6</chain_version>
                    </blockchain>
                    <items>
                        <items>
                            <type>text</type>
                            <title>生产时间</title>
                            <desc>2018-09-26</desc>
                            <ext_info>{&quot;cover&quot;:&quot;default-url&quot;}</ext_info>
                        </items>
                    </items>
                </trace_details>
            </trace_details>
        </data>
        <code></code>
        <msg></msg>
        <success>false</success>
    </result>
</tmall_traceplatform_inner_blockchain_tracedetail_response>

{
    "tmall_traceplatform_inner_blockchain_tracedetail_response":{
        "result":{
            "data":{
                "user_scan_info":{
                    "scan_count":1,
                    "first_scan_time":"2018-09-26"
                },
                "trace_details":{
                    "trace_details":[
                        {
                            "title":"生产信息",
                            "blockchain":{
                                "tx_hash":"asdadsdasda",
                                "item_hash":"asdadasdasd",
                                "biz_type":"WuChangRice",
                                "source":"tmall",
                                "chain_version":"0.6"
                            },
                            "items":{
                                "items":[
                                    {
                                        "type":"text",
                                        "title":"生产时间",
                                        "desc":"2018-09-26",
                                        "ext_info":"{\"cover\":\"default-url\"}"
                                    }
                                ]
                            }
                        }
                    ]
                }
            },
            "code":"",
            "msg":"",
            "success":false
        }
    }
}

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>

错误码	错误描述	解决方案

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

开放平台

天猫国际API

tmall.traceplatform.inner.blockchain.tracedetail (码获取详情接口，包括区块链hash信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ