第三方平台通过调用查询指定任务前排位订单接口(/api/printer/getQueueTasks),向开放平台查询指定打印任务在当前排队队列中前面的所有订单信息,用于业务侧了解某任务前方等待的订单明细与队列情况。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/printer/getQueueTasks |
| 请求方式 | POST |
请求参数
| 参数名 | 参数值(示例) | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节 |
| taskid | 20000196 | string | 是 | 分配的打印任务的唯一编号 |
返回结果
| 字段 | 数据类型 | 参数值(示例) | 参数说明 |
|---|---|---|---|
| code | string | 0 | 返回结果状态码,成功时为 0,失败时为 1 |
| msg | string | Success | 返回结果描述,如:Success |
| data.position | string | 1 | 指定任务的排队打印序号(包括正在打印中的任务,第一个订单为 0) |
注:本接口用途为「查询指定任务前方的排位订单列表」,但原文返回结果仅给出
data.position(排位序号)字段,未提供「前方订单明细」字段,疑与「查询指定打印任务排序」接口返回重复,属资料未提供,如实保留。
若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下: 电 话:137-5177-4454【微信同号】 邮 箱:info@ColorPark.cn