接口描述:

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

请求 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_codeexclude_code,默认将返回该流水号下的所有配送记录。

文档更新时间: 2018-05-21 21:05