To query print tasks, third-party platforms can invoke a dedicated interface to request detailed information regarding specific print tasks from the Open Platform; the platform will synchronously return the relevant task and order statuses.
Interface Information
| API Endpoint | https://www.colorpark.cn/api/Printer/getTask |
|---|---|
| Request Method | POST |
Request Parameters
| Parameter Name | Parameter Value (Example) | Data Type | Required | Description | | ---- | ---- | :----: | ---- | | printer_id | 500001 | string | Yes | The unique ID assigned to the printer; each printer is assigned a distinct number. | | once | 8305 | string| Yes | A random value used during encryption to generate the signature. | | time | 1646790335 | string| Yes | The timestamp used during encryption to generate the signature. | | sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string| Yes | The generated signature; for details on the generation method, please refer to the "Generating Signatures" section within the Underlying Methods [Basic Support] documentation. | | taskid | 20000196 | string| Yes | The unique ID assigned to the print task. |
Return Results
| Parameter Name | Sub-parameter Name | Data Type | Parameter Value (Example) | Description |
|---|---|---|---|---|
| code | string | 0 | Status code of the returned result; 0 indicates success, 1 indicates failure. | |
| msg | string | Submission Successful | Description of the returned result (e.g., "Submission Successful"). | |
| data | taskid | string | 20000196 | Unique identifier for the print task. |
| printer_id | string | 500001 | Unique ID assigned to the printer; each printer is assigned a distinct ID number. | |
| order_id | string | 164679033555822 | Order ID from the third-party platform; generated by the third-party platform, maximum length accepted is 32 characters. | |
| status | string | 0 | Status of the print task: 0: Waiting to print; 1: Printing; 2: Print complete; 3: Print cancelled; 4: Print error. | |
| name | string | Pearl Milk Tea | Product name (e.g., "Pearl Milk Tea," "Boba Milk Tea"). | |
| file | string | https://img.colorpark.cn/api/render/80301001651287933588.png | Image URL | |
| callback | string | http://www.abc.com/api/callback | The callback URL for Party A's system to receive print notifications—such as notifications for print start, completion, cancellation, and failure. | |
| create_time | string | 2022-03-09 14:19:30 | The time the print task was created | |
| start_time | string | 2022-03-09 14:19:30 | The time the print task started printing | |
| finish_time | string | 2022-03-09 14:19:30 | The time the print task finished printing |
If you encounter any unresolved issues during the device commissioning process, please contact the Cloud Printing Administrator for troubleshooting and assistance in finding a solution. Contact details are as follows: Phone: 137-5177-4454 (Same number for WeChat) Email: info@ColorPark.cn