快递查询地图轨迹技术文档

1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回格式支持JSON，xml，text，html数据。

2 请求地址

https://poll.kuaidi100.com/poll/maptrack.do

请求参数（header）

请求参数（body）

param数据结构：

3 请求实例

customer = **
sign = **
param = {
    "com": "ems",
    "num": "em263999513jp",
    "phone": "13868688888",
    "from": "广东省深圳市南山区金蝶软件园",
    "to": "北京朝阳区国际金融大厦",
    "resultv2": "5",
    "show": "0",
    "order": "desc"
}

4 返回结果

5 提供数据内容

{
    "message": "ok",
    "nu": "YT4781863654577",
    "ischeck": "1",
    "com": "yuantong",
    "status": "200",
    "data": [
        {
            "time": "2020-11-30 13:19:56",
    	    "context": "圆通合作点【喵站】快件已到达财富金街院里3号底商驿站,联系电话18744663997",
            "ftime": "2020-11-30 13:19:56",
            "areaCode": null,
            "areaName": null,
            "status": "投柜或驿站"，
            "location": "喵站",
            "areaCenter": "114.056868,32.543099",
            "areaPinYin": "xian",
            "statusCode": "501"
        }   
        }, 
        {
            "time": "2020-09-12 17:40:58",
            "context": "【广东省深圳市平湖公司】 已收件 取件人: 刘杰珍 (18128837173)",
            "ftime": "2020-09-12 17:40:58",
            "areaCode": "CN440307003000",
            "areaName": "广东,深圳市,龙岗区,平湖",
            "status": "揽收"
            "location": null,
            "areaCenter": "114.057868,22.543099",
            "areaPinYin": "shenzhen",
            "statusCode": "1"
        }
    ],
    "state": "501",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN4403",
            "name": "广东,深圳市"
        },
        "cur": {
            "number": "CN6101",
            "name": "陕西,西安市"
        },
        "to": {
            "number": "CN6101",
            "name": "陕西,西安市"
        }
    },
    "isLoop": false,
    "trailUrl": "https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
    "arrivalTime": "2020-12-19 12",
    "totalTime": "2天1小时",
    "remainTime": "1天2小时"
}

6 运单签收状态（state)说明

注：如需物流状态高级状态名称及状态值需要 resultv2 传 “5” 返回

7 轨迹链接应用示例

8 错误返回示例

{
    "result": false,
    "returnCode": "400",
    "message": "找不到对应公司"
}