说明

  • 请求方式：POST
  • 接口地址：/api/collector/returnCollector

Request

参数名 数据类型 描述 是否必传
barCodeList List 需要回寄的采样器(支持批量回寄) 是
senderName String 寄件人名字 是
senderPhone String 寄件人电话 是
sendProv String 寄件地址省份 是
sendCity String 寄件地址城市 是
sendArea String 寄件地址 区/县 是
sendDetailAddr String 寄件详细地址 是
sendMark String 寄件备注信息 否
sendTime String 寄件预约时间，建议提供给用户选择的时间从早上10点到下午17点；
参数格式是 yyyy-MM-dd HH:mm:ss
预约时间应控制在大于当前时间不超过两天时间		 是

Headers

参数名 数据类型 描述 是否必传
token String 接口交互必须的参数和账户验证凭证 是

Response

参数名 数据类型 描述
code int 状态码（只有状态码是 0 时接口响应的数据是成功返回）
msg String 接口相应接口描述（只有状态描述是”OK”才是响应接口成 功，其他都是响应失败的文字描述）
result Object “success”表示预约回寄操作成功收件员会按照预约时间 上门取件

接口请求的示例

Request

  1. {
  2.     "barCodeList": [
  3.         "AAUJ78U87UU9",
  4.         "AAUHYH87Y7U8"
  5.     ],
  6.     "senderName": "张三",
  7.     "senderPhone": "13800000000",
  8.     "sendProv": "上海",
  9.     "sendCity": "上海市",
  10.     "sendArea": "普陀区",
  11.     "sendDetailAddr": "北岸长风，E 栋 A 座 12 楼 1212 室",
  12.     "sendMark": "寄件信息备注",
  13.     "sendTime": "2020-01-08 09:30:00"
  14. }

Response

  1. {
  2.     "code": 0,
  3.     "msg": "OK",
  4.     "result": "success"
  5. }