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
Request Parameters
| Parameter Name |
Parameter Value (Example) |
Data Type |
Required |
Parameter 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 Underlying Methods [Basic Support]. |
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 (e.g., notifications for print start, completion, cancellation, or 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 began printing. |
| finish_time |
string |
2022-03-09 14:19:30 |
The time the print task finished printing. |
| is_merge |
string |
0 |
Whether merged printing is supported. 0: Not supported; 1: Supported. |
| unique |
string |
|
Unique identifier for the item. |
| quantity |
string |
1 |
The quantity of items required for this print task. |
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
A UV Cloud Printing Service Provider with Deep Hardware-Software Integration ® RefineColor
