根据流水号获取配送记录

接口描述：

  • 根据流水号获取配送记录。

请求 URL：

  • http|https://host/api/v1/delivery_dist/method/get.delivery.dist.code/

请求方式：

  • GET
  • POST

是否授权：

  • 需要授权

业务参数：

参数名 类型 是否必须 范围值 默认值 示例值 描述
order_code string 是 max:50 PO_I1049550470 流水号(订单号、售后单号等)
logistic_code string 否 max:50 484106215266 获取该流水号下指定的快递单号
exclude_code array 否 string[] ["123","456"] 排除该流水号下的快递单号

响应参数：

参数名 类型 是否返回 示例值 描述
status integer 是 200 状态码
message string 是 success 消息信息
data array 否 [] 返回数组
data 类型 是否返回 示例值 描述
delivery_dist_id integer 是 3 配送记录编号
user_id integer 是 1 账号编号
order_code string 是 PO_I1049550470 流水号(订单号、售后单号等)
logistic_code string 是 484106215266 快递单号
trace array 是 [] 配送轨迹
accept_station string 是 糯米已揽收 描述
accept_time string 是 2018-03-20 20:51:17 时间
remark string 否 备注
state integer 是 3 配送状态 0=无轨迹 1=已揽收 2=在途中 201=到达派件城市 3=签收 4=问题件
is_sub integer 是 0 是否订阅 0=否 1=是
create_time datetime 是 2018-03-09 23:32:11 创建时间
update_time datetime 是 2018-05-13 00:12:11 更新时间
get_delivery_item object 是 [] 快递公司对象
get_user object 是 [] 账号对象
get_delivery_item 类型 是否返回 示例值 描述
name string 是 中通快递 快递公司名称
code string 是 ZTO 快递公司编码
get_user 类型 是否返回 示例值 描述
username string 否 careya 账号
nickname string 否 careya 昵称
head_pic string 否 //host/head_pic.jpg 头像

响应示例：

  1. {
  2.   "status": 200,
  3.   "message": "success",
  4.   "data": [
  5.     {
  6.       "delivery_dist_id": 3,
  7.       "user_id": 1,
  8.       "order_code": "PO_I1049550470",
  9.       "logistic_code": "484106215266",
  10.       "trace": [
  11.         {
  12.           "accept_station": "糯米已揽收",
  13.           "accept_time": "2018-03-20 20:51:17"
  14.         }
  15.       ],
  16.       "state": 3,
  17.       "is_sub": 0,
  18.       "create_time": "2018-03-09 23:32:11",
  19.       "update_time": "2018-05-13 00:12:11",
  20.       "get_delivery_item": {
  21.         "name": "中通快递",
  22.         "code": "ZTO"
  23.       },
  24.       "get_user": {
  25.         "username": "careya",
  26.         "nickname": "careya",
  27.         "head_pic": "//host/head_pic.jpg"
  28.       }
  29.     },
  30.     {
  31.       "delivery_dist_id": 6,
  32.       "user_id": 1,
  33.       "order_code": "PO_I1049550470",
  34.       "logistic_code": "889138951963212863",
  35.       "trace": [
  36.         {
  37.           "accept_station": "【江苏省盐城市公司】 已收件",
  38.           "accept_time": "2018-04-17 19:38:14"
  39.         }
  40.       ],
  41.       "state": 3,
  42.       "is_sub": 0,
  43.       "create_time": "2018-05-13 00:04:19",
  44.       "update_time": "2018-05-13 00:12:11",
  45.       "get_delivery_item": {
  46.         "name": "圆通速递",
  47.         "code": "YTO"
  48.       },
  49.       "get_user": {
  50.         "username": "careya",
  51.         "nickname": "careya",
  52.         "head_pic": "//host/head_pic.jpg"
  53.       }
  54.     }
  55.   ]
  56. }

备注:

  1. 对于配送记录字段is_sub = 0的记录，在查询时将使用实时查询，如果配送状态已签收则存入数据库，下次查询时将直接从数据库中获得记录。

  2. 除非传入logistic_code或exclude_code，默认将返回该流水号下的所有配送记录。