1、接口說明

1.1、接口一：快遞單號(hào)智能識(shí)別

快遞單號(hào)智能識(shí)別，是根據(jù)查詢的快遞單號(hào)自動(dòng)智能識(shí)別出該運(yùn)單所屬的快遞公司，再獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

1.2、接口二：快遞公司+快遞單號(hào)

快遞公司+快遞單號(hào)，是根據(jù)查詢的快遞公司和快遞單號(hào)，獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

2、接口描述

2.1、功能描述

獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

2.2、URL 示例

2.2.1、接口一：快遞單號(hào)智能識(shí)別

1）http 協(xié)議：

POST 方式請求：

http://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

GET 方式請求：

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

2）https 協(xié)議：

POST 方式請求：

https://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

GET 方式請求：

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

2.2.2、接口二：快遞公司+快遞單號(hào)

1）http 協(xié)議：

POST 方式請求：

http://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

GET 方式請求：

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

2）https 協(xié)議：

POST 方式請求：

https://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

GET 方式請求：

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

3、請求參數(shù)

3.1、數(shù)據(jù)包體

3.1.1、接口一：快遞單號(hào)智能識(shí)別

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getExpressInfo",
    "order": "247198050163",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

3.1.2、接口二：快遞公司+快遞單號(hào)

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getExpressInfoNoSmart",
    "company": "shunfeng",
    "order": "247198050163",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

3.2、參數(shù)說明

3.2.1、接口一：快遞單號(hào)智能識(shí)別

3.2.2、接口二：快遞公司+快遞單號(hào)

3.3、快遞公司代碼

支持的快遞公司代碼及參數(shù)對照如下表：

3.4、其他說明

1）type：可選值 get，如果賦值 get，則以 get 方式提交數(shù)據(jù)；默認(rèn)以 post 方式提交數(shù)據(jù)；

2）sign：簽名校驗(yàn)

當(dāng) module 賦值 getExpressInfo 時(shí)，根據(jù)公式$sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey)生成；

當(dāng) module 賦值 getExpressInfoNoSmart 時(shí)，根據(jù)公式$sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey)生成；

其中：appkey 為授權(quán)接口的 AppKey，請?zhí)顚懩谖乙楣倬W(wǎng)上申請到的 AppKey 。

3）company：快遞公司，賦值快遞公司代碼或擴(kuò)展代碼均可。

3.5、構(gòu)造偽代碼如下

3.5.1、接口一：快遞單號(hào)智能識(shí)別

string type = "get"; //請求方式，可以賦值為：post
string appid = "1000xxxx"; //sdkappid 對應(yīng)的 appid，需要業(yè)務(wù)方高度保密
string module = "getExpressInfo"; //請求的數(shù)據(jù)模塊，此處賦值：getExpressInfo
string order = "247198050163"; //要查詢的快遞單號(hào)
string sign = sha256(appid=1000xxxx&module=getExpressInfo&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

3.5.2、接口二：快遞公司+快遞單號(hào)

string type = "get"; //請求方式，可以賦值為：post
string appid = "1000xxxx"; //sdkappid 對應(yīng)的 appid，需要業(yè)務(wù)方高度保密
string module = "getExpressInfoNoSmart"; //請求的數(shù)據(jù)模塊，此處賦值：getExpressInfoNoSmart
string company = "shunfeng"; //要查詢的快遞公司
string order = "247198050163"; //要查詢的快遞單號(hào)
string sign = sha256(appid=1000xxxx&module=getExpressInfoNoSmart&company=shunfeng&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

4、響應(yīng)參數(shù)

4.1、數(shù)據(jù)包體

{
    "result":1,
    "description":"TRUE",
    "flag":"",
    "expressInfo":{
        "id":"shunfeng",
        "name":"順豐快遞",
        "order":"247198050163",
        "message":"",
        "errcode":"0000",
        "status":4,
        "data":[
            {
                "time":"2018-06-06 17:20:22",
                "content":"順豐速運(yùn) 已收取快件"
            },
            {
                "time":"2018-06-06 19:37:16",
                "content":"快件在【武漢硚口區(qū)硚口營業(yè)點(diǎn)】已裝車,準(zhǔn)備發(fā)往 【武漢走馬嶺集散中心】"
            },
            {
                "time":"2018-06-06 19:47:53",
                "content":"快件已發(fā)車"
            },
            {
                "time":"2018-06-06 20:51:13",
                "content":"快件到達(dá) 【武漢走馬嶺集散中心】"
            },
            {
                "time":"2018-06-06 20:53:46",
                "content":"快件在【武漢走馬嶺集散中心】已裝車,準(zhǔn)備發(fā)往下一站"
            },
            {
                "time":"2018-06-06 21:26:00",
                "content":"快件已發(fā)車"
            },
            {
                "time":"2018-06-06 22:17:29",
                "content":"快件到達(dá) 【武漢總集散中心】"
            },
            {
                "time":"2018-06-07 00:08:13",
                "content":"快件在【武漢總集散中心】已裝車,準(zhǔn)備發(fā)往下一站"
            },
            {
                "time":"2018-06-07 03:16:03",

               "content":"快件到達(dá) 【杭州總集散中心】"
            },
            {
                "time":"2018-06-07 05:45:20",
                "content":"快件在【杭州總集散中心】已裝車,準(zhǔn)備發(fā)往下一站"
            },
            {
                "time":"2018-06-07 08:57:00",
                "content":"快件到達(dá) 【福州總集散中心】"
            },
            {
                "time":"2018-06-07 08:57:30",
                "content":"快件在【福州總集散中心】已裝車,準(zhǔn)備發(fā)往 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 09:30:24",
                "content":"快件已發(fā)車"
            },
            {
                "time":"2018-06-07 10:31:35",
                "content":"快件到達(dá) 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 11:16:19",
                "content":"快件在【福州尚干集散中心】已裝車,準(zhǔn)備發(fā)往 【泉州晉江集散中心】"
            },
            {
                "time":"2018-06-07 12:17:36",
                "content":"快件已發(fā)車"
            },
            {
                "time":"2018-06-07 15:26:19",
                "content":"快件到達(dá) 【泉州晉江集散中心】"
            },
            {
                "time":"2018-06-07 15:52:54",
                "content":"快件在【泉州晉江集散中心】已裝車,準(zhǔn)備發(fā)往下一站"
            },
            {
                "time":"2018-06-07 17:16:21",
                "content":"快件已發(fā)車"
            },
            {
                "time":"2018-06-07 17:52:49",
                "content":"快件到達(dá) 【泉州豐澤招豐村路營業(yè)點(diǎn)】"
            },
            {
                "time":"2018-06-08 08:23:14",
                "content":"快件交給周松壽，正在派送途中（聯(lián)系電話：15906062987）"
            },
            {
                "time":"2018-06-08 09:38:23",
                "content":"快件派送至【豐巢智能快遞柜】,請您憑取件碼至電力職業(yè)技術(shù)學(xué)院原二號(hào)教學(xué)樓旁車庫領(lǐng)取您的快遞."
            },
            {
                "time":"2018-06-08 15:38:40",
                "content":"已簽收(豐巢簽收),感謝使用順豐,期待再次為您服務(wù)"
            }
        ]
    }
}

4.2、參數(shù)說明

expressInfo 參數(shù)說明：

data 參數(shù)說明：