51tracking API

API 调用接口

Manage your trackings

URI	Method	Description
POST /trackings/post	POST	创建单个运单号
GET /trackings/{carrier_code}/{tracking_number}	GET	列出单个运单号物流信息
PUT /trackings/{carrier_code}/{tracking_number}	PUT	修改单个运单号附加信息。如：订单号，商品标题，快递状态等。
DELETE /trackings/{carrier_code}/{tracking_number}	DELETE	删除单个运单号
POST /trackings/batch	POST	创建多个运单号
GET /trackings/get	GET	获取多个运单号的物流信息
POST /trackings/updatemore	POST	修改多个运单号附加信息。如：订单号，商品标题，快递状态等。
POST /trackings/delete	POST	删除多个运单号
POST /trackings/update	POST	修改运输商简码
GET /trackings/getuserinfo	GET	查询用户剩余额度
GET /trackings/getstatusnumber	GET	查看不同状态快递数量
POST /trackings/notupdate	POST	设置部分单号不再更新
POST /trackings/remote	POST	查询收货地址是否偏远
POST /trackings/costtime	POST	获取快递时效
POST /trackings/aircargo	POST	获取空运单号查询结果

获取单个运单号实时物流信息

POST

https://api.51tracking.com/v2/trackings/realtime

REQUEST
RESPONSE

Headers

Content-Type: application/json
Tracking-Api-Key: YOUR_API_KEY

Tips
此接口每秒最多3次请求

Parameters

Required/Optional Parameters

Param	描述
`tracking_number`	快递单号
`carrier_code`	运输商简码
`destination_code` (optional)	目的国二字简码.
`tracking_ship_date`(optional)	寄件日期，格式为20181001（年月日），部分运输商（如德国邮政）要求填写发件日期才可以查询物流信息，故查询此类运输商时需要传此参数
`tracking_postal_code`(optional)	收件地邮编，部分运输商（如Mondial Relay法国快递）要求填写邮编才可以查询物流信息，故查询此类运输商时需要传该参数
`tracking_account_number`(optional)	账户号，部分快递要求填写账户号才可以查询物流，故查询此类快递时需要传该参数
`specialNumberDestination`(optional)	目的国参数，部分运输商要求填写目的国家才可以查询物流，故查询此类快递时需要传该参数
`order` (optional)	Text field for order ID.
`order_create_time` (optional)	包裹发货时间(eg:2017/8/27 16:51).
`lang` (optional)	返回语言类型 (仅当快递官网支持时有用).了解更多信息
`auto_correct` (optional)	如果将值设置为 1, 系统将不会根据单号自动矫正快递商.
`comment` (optional)	备注

Request Body

{
    "tracking_number": "LS912989618CN",
    "carrier_code": "china-ems",
    "destination_code": "US",
    "order": "12645654",
    "order_create_time": "2017/8/27 16:51",
    "comment": "备注"
}

Response Body `200`

{
    "meta": {
        "code": 200,
        "type": "Success",
        "message": "Success"
    },
    "data": {
        "items": [{
            "id": "f1e0645c3288bae10b8ab6ad89ca187b",
            "tracking_number": "LS912989618CN",
            "carrier_code": "china-ems",
            "order_create_time": "2017\/8\/27 16:51",
            "status": "transit",
            "original_country": "China",
            "destination_country": "United States",
            "itemTimeLength": 11,
            "stayTimeLength": 4,
            "service_code": null,
            "origin_info": {
                "ItemReceived": "2018-04-07 16:45:00",
                "ItemDispatched": null,
                "DepartfromAirport": null,
                "ArrivalfromAbroad": "2018-04-14 17:07:00",
                "CustomsClearance": null,
                "DestinationArrived": null,
                "weblink": "http:\/\/www.ems.com.cn\/",
                "phone": "11183",
                "carrier_code": "china-ems",
                "trackinfo": [{
                    "Date": "2018-04-14 17:07:00",
                    "StatusDescription": "到达处理中心,来自中国 郑州",
                    "Details": "美国",
                    "checkpoint_status": "transit"
                }, {
                    "Date": "2018-04-07 21:18:37",
                    "StatusDescription": "离开郑州市 发往旧金山",
                    "Details": "郑州市",
                    "checkpoint_status": "transit"
                }, {
                    "Date": "2018-04-07 16:45:00",
                    "StatusDescription": "中国邮政速递物流股份有限公司河南省国际速递分公司五已收件（揽投员姓名：,联系电话:）",
                    "Details": "郑州市",
                    "checkpoint_status": "transit"
                }]
            },
            "lastEvent": "Arrived at USPS Regional Destination Facility,DES MOINES IA NETWORK DISTRIBUTION CENTER,2018-04-17 22:30",
            "lastUpdateTime": "2018-04-17 22:30"
        }]
    }
}

查物流轨迹，就用51Tracking

联系我们

API 调用接口

获取单个运单号实时物流信息

Headers

Tips

Parameters

Request Body

Response Body 200

Response Body `200`