联系客服: iP138客服 |

快递查询接口文档说明

接口说明

http协议:http://api.ip138.com/express/info/ 查询快递信息
https协议:https://api.ip138.com/express/info/ 查询快递信息
http协议:http://api.ip138.com/express/com/ 查询快递公司
https协议:https://api.ip138.com/express/com/ 查询快递公司

请求方式

get

示例1(Linux命令行下执行)

参数说明:
1. no string no快递单号
2. token string 购买服务后会提供(必填)

curl "http://api.ip138.com/express/info/?no=100613574827" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"
curl "http://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 购买服务后提供(必填)

http://api.ip138.com/express/info/?no=100613574827&oid={oid}&mid={mid}&sign=签名算法
http://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 购买服务后提供(必填)

http://api.ip138.com/express/info/?no=100613574827&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57
http://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

http://api.ip138.com/status/

请求方式

get

参数

1. token `string`

示例

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

响应

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