第三方平台通过调用查询指定打印任务排序接口（/api/printer/getTaskPosition），向开放平台查询指定打印任务的排队排位序号（从 0 开始排序，包含正在打印中的任务），用于业务侧了解某任务在队列中的先后顺序与等待位置。
注：升级或安装最新版本的云打印客户端才可使用当前功能（可与官方技术团队确认客户端版本）。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/printer/getTaskPosition |
| 请求方式 | 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） |
若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn