Query Currently Printing Task

Last updated：2026-10-13 11:38:15

Query Currently Printing Task

A third-party platform calls the Query Printing Orders interface (/api/task/getPrintingPrintTask) to send a command to the open platform querying the list of orders that are currently in the printing state on a designated printer. After processing, the platform returns synchronously the details of the printing orders (such as task ID, order number, product name, image URL, and status) for real-time monitoring of the task progress currently being executed by the device.

Interface Information

Item Value
Endpoint https://www.colorpark.cn/api/task/getPrintingPrintTask
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.

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 array [{}] Returned data (array).
data[].taskid string 20281112 The unique ID of the print task.
data[].order_id string 164679033555825 The order number from the third-party platform, generated by the third party; accepts up to 32 characters.
data[].name string Pearl Milk Tea Product name, e.g., Pearl Milk Tea, Boba Milk Tea.
data[].file string https://img.colorpark.cn/render/2025/09/11/8125017/1684505_17575600957909.png The image URL.
data[].file_bgc string https://img.colorpark.cn/render/2025/09/11/8125017/1684505_17575600957909.png The image outer-frame URL.
data[].status string 1 1 = printing.
data[].white_ink string 0 0 = no white ink, 1 = white ink.
data[].callback string http://www.abc.com/api/callback The callback URL of the client (party A) system for receiving print notifications — e.g., print-start, print-complete, print-cancel, and print-fault notifications.
data[].create_time string 2025-11-26 17:06:12 The order creation time.
data[].start_time string 2025-11-26 17:06:12 The order print start time.
data[].status_text string Printing Order print status: Printing.

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

UV cloud-printing service provider with deep hardware–software integration ® Ruifengcai