3-3-2. 处理
接口说明:
URL | http://test.birdsystem.com/client/Temp-Consignment-Info/Convert-Into-Consignment/ | ||
---|---|---|---|
接口功能 | 将批量代理专线订单处理到正式订单列表 | ||
支持格式 | JSON | 开发人员 | |
请求方式 | GET | 发布日期 |
参数说明:
参数 | 说明 | 必选 | 类型 |
---|---|---|---|
ids | 批量订单的id,多个订单用下划线分隔(如果没有写id, 则默认转换所填type的所有未转换的批量订单) | VARCHAR(50) | |
type | 转换的类型 | Y | 'AGENT_DIRECT' |
start | 从第几个开始处理(不填的话系统默认为0) | VARCHAR(10) |
请求示例:
接口返回示例:
其中taskId是当前正在运行的后台任务的id;并非批量订单的id。 (目前 convert-into-consignment 使用后台任务模式,开启一个后台任务后, 不等后台完成,就返回后台任务的id)
查询批量订单运行结果:
返回taskId后,如需要查询task的状态,可以1分钟调用一次(一次只能查一个后台任务)
http://test.birdsystem.com/client/Gearman-background-tasks/Get-Detail?id=xxxx
返回示例:
返回参数说明:
参数 | 说明 |
---|---|
taskId | 运行的后台任务的id |
status | 有'QUEUE' (排队中),'RUNNING'(运行中),'FINISH' (已完成),'ERROR' (出错),'ABORTED' (已被人为中断) 几种状态,只有当status为'FINISH'时, data,errorData才会有数据 |
create_time | 后台任务创建时间 |
start_time | 后台任务开始时间 |
finish_time | 后台任务完成时间 |
data | 返回的键值对分别是 临时批量订单的id,正式订单的id |
errorData | 返回的键值对分别是 临时订单id,错误信息 |
注:
现在系统使用后台任务队列来处理订单,订单较多时,处理需要较长时间,可长达一小时,所以处理结果是不会实时返回的。每调用一次convert-into-consignment,会创建一个任务,根据这个任务id来了解后台进度。
点击处理,或者发convert请求,只是开启一个后台任务,就告诉客户后台任务开始了;至于后台任务最后是成功还是失败,是要不停地去查http://test.birdsystem.com/client/Gearman-background-tasks/Get-Detail?id=xxxx接口状态才知道。