A third-party platform calls the update configuration parameters interface (
/api/printer/pushConfig) to send a request to the open platform, which forwards it to the printer client software on the specified device and synchronously updates the device's operating configuration parameters. It is used to uniformly adjust print-output and device-operation-related settings, and returns the operation status synchronously. Note: this feature requires the latest version of the cloud-printing client to be upgraded or installed.
Note: This feature is available only after upgrading or installing the latest version of the cloud-printing client (confirm the client version with the official technical team).
Interface Information
- Interface URL:
https://www.colorpark.cn/api/printer/pushConfig - Request Method: POST
Request Parameters
| Parameter | Example Value | Data Type | Required | Description |
|---|---|---|---|---|
printer_id |
500001 | string | Yes | The unique ID assigned to the printer; each printer is assigned a different number. |
once |
8305 | string | Yes | A random value 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. For the generation method, refer to the "Generate Signature" section under "Underlying Methods [Basic Support]". |
data |
{"channel_1_x_left":"99","channel_2_x_left":"2","channel_3_x_left":"3","channel_1_y_top":"0","channel_2_y_top":"2","channel_3_y_top":"3"} |
string (JSON) | Yes | Configuration parameters. |
The
dataobject carries the per-channel X (left) and Y (top) position offsets for channels 1–3 (e.g.channel_1_x_left,channel_2_y_top), used to calibrate each channel's print position. The original sample used inconsistent spacing between key-value pairs; it has been normalized into valid JSON above.
Response Result
| Parameter | Data Type | Example Value | Description |
|---|---|---|---|
code |
string | 0 | Result status code: 0 = success, 400 = failure. |
msg |
string | 推送成功 | Result description, e.g. "Push successful". |
If the device encounters an unsolvable issue during debugging, contact the cloud-printing responsible person for troubleshooting and a resolution. Contact details:
Phone: 137-5177-4454 (same number on WeChat)
Email: info@ColorPark.cn