ECJiaWiki:Api:order/express

来自ECJiaWiki
跳转至: 导航搜索

应用场景

 获取订单物流信息

接口名称

 order/express

Header请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
设备唯一ID device-udid String a46d663d675d4858ea7d0a21c2de06e9 设备的唯一编号 1.3.0
设备客户端类型 device-client String android,iphone,h5,weapp 设备类型的描述 1.3.0
产品编号 device-code String 6015 产品编号 1.3.0
API版本 api-version String 1.6 API接口版本号 1.3.0

举例如下

{
    "device-udid" : "a46d663d675d4858ea7d0a21c2de06e9",
    "device-client" : "weapp",
    "device-code " : "6015",
    "api-version" : "1.6",
}

Body请求参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
token请求凭证 token String 调用接口凭证 1.3.0
订单id order_id Int 订单id 1.3.0

举例如下

{
    "token": "d122e3c72332c5af12a71d77c9f1462f5901d276",    //session_id的加密
    "order_id": 1,   //订单id
}

返回参数

字段名 变量名 必填 类型 示例值 描述 since deprecated
成功状态 status status字典 返回接口请求成功状态 1.3.0
└ 是否成功 succeed Int 是否成功(1、代表成功,2、代表错误) 1.3.0
返回信息 data Json 返回信息 1.3.0
└ 返回内容 content Array 返回内容 1.3.0
  └ 物流时间 time Stging 2015-01-14 18:46:20 物流时间 1.3.0
  └ 物流位置 location String 物流位置 1.3.0
  └ 物流信息 context String 快件已签收,签收人是草签,签收网点是原平分部(13453073116) 物流信息 1.3.0
物流名称 shipping_name String 天天 物流名称 1.3.0
物流单号 shipping_number String 666022958618 物流单号 1.3.0
物流状态 status Int 1 1、签收 0、未签收 1.3.0

成功举例如下

{
    "data": {
        "content": [
            {
                "time": "2015-01-14 18:46:20",
                "location": "",
                "context": "快件已签收,签收人是草签,签收网点是原平分部(13453073116)"
            },
            {
                "time": "2015-01-14 11:54:02",
                "location": "",
                "context": "原平分部(13453073116)的叶师傅13918755703正在派件,扫描员是王良波18957630809"
            },
            {
                "time": "2015-01-14 09:37:27",
                "location": "",
                "context": "快件到达原平分部(13453073116),上一站是上海闸北一部(021-66246808,66246811)扫描员是王良波18957630809"
            },
            {
                "time": "2015-01-14 03:48:09",
                "location": "",
                "context": "快件在上海集散由杜利萍扫描发往上海闸北一部(021-66246808,66246811)"
            },
            {
                "time": "2015-01-13 19:57:01",
                "location": "",
                "context": "快件在永康(0579-89206888)由陆丽扫描发往金华分拨中心"
            },
            {
                "time": "2015-01-13 19:57:00",
                "location": "",
                "context": "永康(0579-89206888)已进行装袋 扫描,袋号220034617861,扫描员是陆丽"
            },
            {
                "time": "2015-01-13 19:45:55",
                "location": "",
                "context": "永康(0579-89206888)的王广田已收件,扫描员是今日高"
            }
        ],
        "shipping_name": "天天",
        "shipping_number":"666022958618",
        "status" : 1,       //是否签收  1、签收  0、未签收
    },
    "status": {
        "succeed": 1
    }
}

失败举例如下

{
  "status": {		//状态
    "succeed": 0;		//是否成功
    "error_code": 'express_error';		//错误编码
    "error_desc": "快递公司网络异常,请稍后查询!";		//错误信息
  }
}


注:错误编码