快递查询接口文档说明

接口说明

查询快递信息http协议：
国内大陆优化（支持ipv6）http://api.ipshudi.com/express/info/
国际各洲覆盖（部份ipv6）http://api.ip138.com/express/info/

查询快递信息https协议：
国内大陆优化（支持ipv6）https://api.ipshudi.com/express/info/
国际各洲覆盖（部份ipv6）https://api.ip138.com/express/info/

查询快递公司http协议：
国内大陆优化（支持ipv6）http://api.ipshudi.com/express/com/
国际各洲覆盖（部份ipv6）http://api.ip138.com/express/com/

查询快递公司https协议：
国内大陆优化（支持ipv6）https://api.ipshudi.com/express/com/
国际各洲覆盖（部份ipv6）https://api.ip138.com/express/com/

请求方式

get

示例1（Linux命令行下执行）

参数说明:
1. no string no快递单号
2. token string 购买服务后会提供（必填）
3. callback string 回调函数（可选，默认为空）

curl "https://api.ip138.com/express/info/?no=100613574827" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"
curl "https://api.ip138.com/express/com/?no=100613574827" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"

示例2（js引入推荐方案）

参数说明:
1. no string no快递单号
2. sign string 签名验证 签名算法:md5("no=" + no + "&token=" + token)（必填）
3. oid string 购买服务后提供（必填）
4. mid string 购买服务后提供（必填）
5. callback string 回调函数（可选，默认为空）

https://api.ip138.com/express/info/?no=100613574827&oid={oid}&mid={mid}&sign=签名算法
https://api.ip138.com/express/com/?no=100613574827&oid={oid}&mid={mid}&sign=签名算法

示例3（为了您的token安全，请勿使用于js引入，js引入请参考示例2）

参数说明:
1. no string no快递单号
2. sign string 签名验证 签名算法:md5("no=" + no + "&token=" + token)（必填）
3. oid string 购买服务后提供（必填）
4. mid string 购买服务后提供（必填）

https://api.ip138.com/express/info/?no=100613574827&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
https://api.ip138.com/express/com/?no=100613574827&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57

快递信息查询 JSON返回示例

说明：ret 值为 ok 时 返回data查询结果数据 为err时返回msg错误信息

{
    "ret":"ok",  // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "data":
       {
        "company":"圆通速递",
        "companytype":"yuantong",
        "traces":[
            {"time":"2016-07-17 11:11:51","context":"客户 签收人 : 他人代收 已签收  感谢使用圆通速递，期待再次为您服务"},
            {"time":"2016-07-17 08:32:02","context":"广东省派件中"},
                 ],
        "state":6 //快递状态    3 运输中，4 揽件，5 出现问题，6 已签收，7 已退签，8 派件中，9 退回中
        }
    }
}

快递公司查询 JSON返回示例

说明：ret 值为 ok 时 返回data查询结果数据 为err时返回msg错误信息

{
    "ret": "ok",    // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "data": [
       {"code":"yuantong","name":"圆通速递"}
    ]
}

查询token使用情况

URL

https://api.ip138.com/status/

请求方式

get

参数

1. token `string`

示例

https://api.ip138.com/status/?token=cc87f3c77747bccbaaee35006da1ebb65e0bad57

响应

{
    "ret":"ok",
    "data":{
        "reqs":10,   //当前小时请求数
        "hour":3000, //当前小时购买次数
        "package":19767 //配额次数
    }
}