API接口

一、基本信息

1.通信方式:

HTTP的POST方法

2.数据格式

响应数据采用JSON

 

3.请求参数

所有数据均为字符型.

Key(必填参数)

请求key(32位),公司提供给合作网站的识别字符串,用于识别和鉴定请求来源,避免未授权的非法访问

其它参数

按实际需要填写,见下面接口说明

4.响应数据

Code

结果状态码

200 - 成功返回

600 – 服务器异常

603 – 参数错误

Message

描述返回错误信息

二、API说明

1.查单

/HttpServer/Track.ashx

请示参数:

POST参数名

是否必填

说明

Key

公司发放的key

Orders

运单号,多个用英文逗号隔开(,).一次最多查10个运单

ExpressDomain

快递公司域名

 

返回对象 Response

属性名

说明

Code

状态码

200 - 成功返回

600 – 服务器异常

603 – 参数错误

 

Message

描述返回错误信息

Datas

TrackModel数组 - 运单的信息, TrackModel具体见下表

 

返回对象 TrackModel

属性名

说明

OrderNum

运单号

Datas

TrackDatasModel数组 – 轨迹信息数组, TrackDatasModel具体见下表

 

返回对象 TrackDatasModel

属性名

说明

Time

时间

Desc
轨迹描述

 

成功返回或失败返回参数,请见示例

示例

成功返回值:

{

  "Code": "200",

  "Datas": [

    {

      "OrderNum": "MLD104487697",

      "Datas": [

        {

          "Time": "2/5/2018 5:24:09 PM",

          "Desc": "运单创建"

        },

        {

          "Time": "2/5/2018 5:24:09 PM",

          "Desc": "等待处理"

        }

      ]

    },

    {

      "OrderNum": "AD104488001",

      "Datas": [

        {

          "Time": "2/5/2018 6:16:51 PM",

          "Desc": "运单创建"

        }

      ]

    },

    {

      "OrderNum": "AD104432189",

      "Datas": [

        {

          "Time": "9/27/2017 7:01:19 PM",

          "Desc": "运单创建"

        },

        {

          "Time": "9/27/2017 7:01:19 PM",

          "Desc": "等待处理"

        },

        {

          "Time": "9/30/2017 8:14:35 AM",

          "Desc": "包裹扫描入库USLA"

        },

        {

          "Time": "9/30/2017 9:15:11 AM",

          "Desc": "包裹已出库USLA"

        },

        {

          "Time": "9/30/2017 10:15:45 AM",

          "Desc": "已发往洛杉矶国际机场LAX"

        },

        {

          "Time": "10/1/2017 2:16:19 AM",

          "Desc": "飞往中国"

        },

        {

          "Time": "10/3/2017 9:59:30 AM",

          "Desc": "抵达海关,等候清关"

        },

        {

          "Time": "10/6/2017 2:30:18 PM",

          "Desc": "海关清关中"

        },

        {

          "Time": "10/9/2017 5:36:59 PM",

          "Desc": "已清关完毕等待转运单号中"

        },

        {

          "Time": "10/9/2017 12:00:00 AM",

          "Desc": "派送单号:中速速递 535147836512"

        }

      ]

    }

  ]

}

 

失败返回值:

{

    "Code": "600",

    "Message": "Key Error!",

}