1、接口说明

1.1、接口一：快递单号智能识别

快递单号智能识别，是根据查询的快递单号自动智能识别出该运单所属的快递公司，再获取快递公司及实时的运单状态和运单状态等信息。

1.2、接口二：快递公司+快递单号

快递公司+快递单号，是根据查询的快递公司和快递单号，获取快递公司及实时的运单状态和运单状态等信息。

2、接口描述

2.1、功能描述

获取快递公司及实时的运单状态和运单状态等信息。

2.2、URL 示例

2.2.1、接口一：快递单号智能识别

1）http 协议：

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 协议：

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、接口二：快递公司+快递单号

1）http 协议：

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 协议：

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、请求参数

3.1、数据包体

3.1.1、接口一：快递单号智能识别

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

3.1.2、接口二：快递公司+快递单号

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

3.2、参数说明

3.2.1、接口一：快递单号智能识别

3.2.2、接口二：快递公司+快递单号

3.3、快递公司代码

支持的快递公司代码及参数对照如下表：

3.4、其他说明

1）type：可选值 get，如果赋值 get，则以 get 方式提交数据；默认以 post 方式提交数据；

2）sign：签名校验

当 module 赋值 getExpressInfo 时，根据公式$sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey)生成；

当 module 赋值 getExpressInfoNoSmart 时，根据公式$sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey)生成；

其中：appkey 为授权接口的 AppKey，请填写您在我要查官网上申请到的 AppKey 。

3）company：快递公司，赋值快递公司代码或扩展代码均可。

3.5、构造伪代码如下

3.5.1、接口一：快递单号智能识别

string type = "get"; //请求方式，可以赋值为：post
string appid = "1000xxxx"; //sdkappid 对应的 appid，需要业务方高度保密
string module = "getExpressInfo"; //请求的数据模块，此处赋值：getExpressInfo
string order = "247198050163"; //要查询的快递单号
string sign = sha256(appid=1000xxxx&module=getExpressInfo&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

3.5.2、接口二：快递公司+快递单号

string type = "get"; //请求方式，可以赋值为：post
string appid = "1000xxxx"; //sdkappid 对应的 appid，需要业务方高度保密
string module = "getExpressInfoNoSmart"; //请求的数据模块，此处赋值：getExpressInfoNoSmart
string company = "shunfeng"; //要查询的快递公司
string order = "247198050163"; //要查询的快递单号
string sign = sha256(appid=1000xxxx&module=getExpressInfoNoSmart&company=shunfeng&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

4、响应参数

4.1、数据包体

{
    "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":"顺丰速运 已收取快件"
            },
            {
                "time":"2018-06-06 19:37:16",
                "content":"快件在【武汉硚口区硚口营业点】已装车,准备发往 【武汉走马岭集散中心】"
            },
            {
                "time":"2018-06-06 19:47:53",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-06 20:51:13",
                "content":"快件到达 【武汉走马岭集散中心】"
            },
            {
                "time":"2018-06-06 20:53:46",
                "content":"快件在【武汉走马岭集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-06 21:26:00",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-06 22:17:29",
                "content":"快件到达 【武汉总集散中心】"
            },
            {
                "time":"2018-06-07 00:08:13",
                "content":"快件在【武汉总集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 03:16:03",

               "content":"快件到达 【杭州总集散中心】"
            },
            {
                "time":"2018-06-07 05:45:20",
                "content":"快件在【杭州总集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 08:57:00",
                "content":"快件到达 【福州总集散中心】"
            },
            {
                "time":"2018-06-07 08:57:30",
                "content":"快件在【福州总集散中心】已装车,准备发往 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 09:30:24",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 10:31:35",
                "content":"快件到达 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 11:16:19",
                "content":"快件在【福州尚干集散中心】已装车,准备发往 【泉州晋江集散中心】"
            },
            {
                "time":"2018-06-07 12:17:36",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 15:26:19",
                "content":"快件到达 【泉州晋江集散中心】"
            },
            {
                "time":"2018-06-07 15:52:54",
                "content":"快件在【泉州晋江集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 17:16:21",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 17:52:49",
                "content":"快件到达 【泉州丰泽招丰村路营业点】"
            },
            {
                "time":"2018-06-08 08:23:14",
                "content":"快件交给周松寿，正在派送途中（联系电话：15906062987）"
            },
            {
                "time":"2018-06-08 09:38:23",
                "content":"快件派送至【丰巢智能快递柜】,请您凭取件码至电力职业技术学院原二号教学楼旁车库领取您的快递."
            },
            {
                "time":"2018-06-08 15:38:40",
                "content":"已签收(丰巢签收),感谢使用顺丰,期待再次为您服务"
            }
        ]
    }
}

4.2、参数说明

expressInfo 参数说明：

data 参数说明：