Send Print Job
Submit the first job — pass the order ID, image, and dimensions, then save the returned task ID.
Before You Start
Prepare an onboarded device, its device ID and secret key, an accessible image URL, and the actual print dimensions. Keep the secret key on the server side; never embed it in a web page.
Submitting successfully does not mean printing is finished. Save the returned task ID. Only when the device is set to secondary confirmation do you need to additionally call "Start Printing".
[Next: Confirm & Start when needed →]
Third-party platforms use this interface to send a single print job to a designated device; the open platform automatically dispatches it to that device's terminal software for execution. Offline job submission is supported — the terminal receives and executes automatically once it comes online. When calling from a fully self-service device, channel information must be included, and the device automatically prints the product for the specified channel.
Note: When using a fully self-service device, this interface is called with channel parameters, and the device automatically completes printing for the specified channel's product. Desktop order-receiving software新增 (new): print mode and ink mode (requires upgrading the order-receiving software to the latest version V3.5.1).
Interface Information
| Item | Value |
|---|---|
| Endpoint | https://www.colorpark.cn/api/Printer/mulPrint |
| Method | POST |
Request Parameters
| Parameter | Example | Type | Required | Description |
|---|---|---|---|---|
| printer_id | 500001 | string | Yes | The unique ID assigned to the printer; each printer gets a different number. |
| once | 8305 | string | Yes | A random value (nonce) used when generating the encrypted signature. |
| time | 1646790335 | string | Yes | The timestamp used when generating the encrypted signature. |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | The generated signature. See the "Generate Signature" section under Underlying Methods [Basic Support]. |
| order_id | 164679033555822 | string | Yes | The order number from the third-party platform (generated by the platform; max 32 characters). |
| name | phone case | string | Yes | The product name from the third-party platform (generated by the platform; max 32 characters). |
| file | https://img.colorpark.cn/api/render/36531651306594235.png |
string | Yes | Image URL. See Parameter Notes below. |
| file_bgc | https://img.colorpark.cn/back/6167751754907026663.png |
string | Optional | Background effect image shown on the print progress bar. URL max 255 characters; supports jpg/png (jpg/png recommended); only some models supported — confirm with technical staff. |
| width | 185 | string | Yes | Printed image width, in mm. |
| height | 140 | string | Yes | Printed image height, in mm. |
| left | 0 | string | Yes | Left margin of the print origin, in mm. |
| top | 0 | string | Yes | Top margin of the print origin, in mm. |
| channel_type | 1 | string | Optional | Currency placed in the channel: 1 if both channels hold the same currency, 2 if the two channels hold different currencies. |
| channel | 1 | string | Optional | The commemorative-coin channel: 1 for channel 1, 2 for channel 2; keep 1 when both channels hold the same currency. |
| ink_mode | 0 | int | Optional | See Ink Mode — Details below. |
| ink_item | [{"code":"W","layer":1},{"code":"CMYK","layer":1}] |
string | Optional | See Ink Item — Details below. |
| is_format_conversion | 0 | string | Optional | Default 0 = print the original file; 1 = convert the original file to an image format before printing. |
| callback | http://www.abc.com/api/callback |
string | Optional | Callback URL on the third-party system for receiving print notifications (print-started, print-finished, print-cancelled, print-fault). |
Request Parameters (Multi-Task Merged Printing, model-limited)
Note: To print different-product orders simultaneously, use the parameters below. The first call requires contacting the official team to add the device fixture. Obtain the product identifier unique via the Query Fixture Products interface.
| Parameter | Example | Type | Required | Description |
|---|---|---|---|---|
| printer_id | 500001 | string | Yes | The unique ID assigned to the printer. |
| once | 8305 | string | Yes | Random value (nonce) for signature generation. |
| time | 1646790335 | string | Yes | Timestamp for signature generation. |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | The generated signature. |
| order_id | 164679033555822 | string | Yes | Third-party order number (max 32 characters). |
| name | phone case | string | Yes | Third-party product name (max 32 characters). |
| file | https://img.colorpark.cn/api/render/36531651306594235.png |
string | Yes | Image URL. See Parameter Notes below. |
| file_bgc | https://img.colorpark.cn/back/6167751754907026663.png |
string | Optional | Background effect image; URL max 255 chars; jpg/png; some models only. |
| is_merge | 1 | string | Yes | Whether it is a merged order: 0 = no, 1 = merged print order. |
| unique | RefrigeratorMagnet | string | Yes | Unique product identifier. |
| quantity | 1 | string | Yes | Print quantity for the current order's product. |
| ink_mode | 0 | int | Optional | See Ink Mode — Details below. |
| ink_item | [{"code":"W","layer":1},{"code":"CMYK","layer":1}] |
string | Optional | See Ink Item — Details below. |
| callback | http://www.abc.com/api/callback |
string | Optional | Callback URL for print notifications. |
Response
| Field | Type | Example | Description |
|---|---|---|---|
| code | string | 0 | Result status code. 0 on success, 1 on failure. |
| msg | string | submitted successfully | Result description, e.g. "submitted successfully". |
| data.taskid | string | 20000196 | Unique print-job ID. |
| data.order_id | string | 164679033555822 | Third-party order number (max 32 characters). |
| data.status | string | 0 | Print-job status: 0 waiting, 1 printing, 2 done, 3 cancelled, 4 fault. |
Callback Notification
Method: POST
| Parameter | Type | Example | Description |
|---|---|---|---|
| type | string | printing | Event type: printing (printing), finish (finished), cancel (cancelled), pause (paused), failure (failed), shipped (dispensed). |
| taskid | int | 10041 | Task ID. |
| printer_id | int | 1000926 | Device ID. |
| once | int | 0254 | Random value. |
| time | int | 1778048444 | Timestamp. |
| sign | string | 06caec435ebbf494e8ed73fdc5daa0a8 | Signature. |
| order_id | string | 1844398 | Order ID. |
| status | string | 1 | Print status: 1 printing, 2 finished, 3 cancelled, 4 paused, 5 failed, 6 dispensed. |
| msg | string | printing | Message. |
Ink Item — Details (model-limited)
code: ink-item identifier.layer: number of print layers.
| Identifier (ink_mode) | Name | Parameter (ink_item) |
|---|---|---|
| 0 | CMYK | [{ "code": "W", "layer": 1 }] |
| 1 | W>CMYK | [{ "code": "W", "layer": 1 },{ "code": "CMYK", "layer": 1 }] |
| 2 | Spot Color | [{ "code": "P", "layer": 1 }] |
| 3 | White | [{ "code": "W", "layer": 1 }] |
| 4 | CMYK>W | [{ "code": "CMYK", "layer": 1 },{ "code": "W", "layer": 1 }] |
| 13 | Embossed | [{"code":"W","layer":8},{"code":"CMYK","layer":1}] |
| 15 | Food Engraving | [{"code":"CMYK","layer":1},{"code":"S", "layer":1}] |
Ink Item — Identifiers (model-limited)
| Identifier | Name | Default | Min | Max |
|---|---|---|---|---|
| W | White | 1 | 1 | 8 |
| CMYK | Color Ink | 1 | 1 | 1 |
| V | Varnish | 1 | 1 | 1 |
| S | Stroke / Outline | 0 | 1 | 1 |
| P | Spot Color | 0 | 0 | 1 |
Ink Item — Parameter Notes (Embossed & Engraving Scenarios, model-limited)
Embossed printing: reference params: ink_mode=13, ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/tmp/2026/09/0c94cf9aa93dd5bf10acda49474c72cddf8452e1_3203.tif,https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
Notes: ink_item: 13 (see Ink Item — Details); ink_item: [{"code":"W","layer":8} (first pass: grayscale image printed with white ink x8), {"code":"CMYK","layer":1}] (second pass: original image printed in color x1); file: provide 2 images (required) — first is the grayscale image, second is the original; separate with a comma.
------------------------------------------------------------
Embossed printing (auto-composite): reference params: ink_mode=13, ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
Notes: ink_item: 13 (see Ink Item — Details); ink_item: [{"code":"W","layer":8} (first pass: grayscale image printed with white ink x8, grayscale generated by the open platform), {"code":"CMYK","layer":1}] (second pass: original image printed in color x1); file: provide 1 image — the original to be converted to embossed.
------------------------------------------------------------
Food engraving: reference params: ink_item=15
ink_item=[{"code":"CMYK","layer":1},{"code":"S", "layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
Notes: ink_mode: 15 (see Ink Item — Details); ink_item: {"code":"CMYK","layer":1} (color print, layer default 1) {"code":"S", "layer":1} (layer: 0 = no stroke, 1 = stroke 1 pixel); file: provide 1 image — the original to be engraved.
------------------------------------------------------------
Other printing: refer to [Ink Item — Details] for ink_mode / ink_item values.
file = the image URL to print, generated by the third-party platform; URL max 255 characters; supports jpg/png/tif (jpg/png recommended).If a device encounters an unresolved issue during debugging, contact the cloud-printing responsible person for troubleshooting. Phone: 137-5177-4454 (WeChat same number); Email: info@ColorPark.cn
© Ruifengcai (瑞丰彩) — UV cloud-printing service provider with deep hardware–software integration