Query Specified Task Position
A third-party platform calls the Query Specified Task Position interface (
/api/printer/getTaskPosition) to query the open platform for the queue position number of a specified print task (zero-based ordering, including tasks currently printing). This is used by the business side to understand a task's sequence and waiting position in the queue.
Note: This feature requires upgrading to or installing the latest version of the cloud-printing client (you may confirm the client version with the official technical team).
Interface Information
| Item | Value |
|---|---|
| Endpoint | https://www.colorpark.cn/api/printer/getTaskPosition |
| Method | POST |
Request Parameters
| Parameter | Sample Value | Data Type | Required | Description |
|---|---|---|---|---|
| printer_id | 500001 | string | Yes | The unique ID assigned to the printer; each print job is assigned a distinct ID. |
| once | 8305 | string | Yes | A random value used when generating the signature (nonce). |
| time | 1646790335 | string | Yes | The timestamp used when generating the signature. |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | The generated signature. For the generation method, refer to the "Signature Generation" section in the Underlying Methods [Basic Support] document. |
| taskid | 20000196 | string | Yes | The unique ID assigned to the print task. |
Response Result
| Field | Data Type | Sample Value | Description |
|---|---|---|---|
| code | string | 0 | Result status code: 0 for success, 1 for failure. |
| msg | string | Success | Result description, e.g., "Success". |
| data.position | string | 1 | The queue print sequence number of the specified task (including tasks currently printing; the first order is 0). |
If a device encounters an unsolvable issue during debugging, please contact the cloud-printing lead to troubleshoot and resolve it. Contact details: Phone: 137-5177-4454 (WeChat same number) Email: info@ColorPark.cn