Third parties must configure a custom callback URL on the open platform. When a printer's status is updated, the open platform pushes the printer status information to that address in real time via POST, enabling the third party to monitor device operating status in real time and perform follow-up processing (e.g., alerts, scheduling, statistics).
Callback URL
Printer status callback: merchants created before 2025-11-19 use the v1 version.
| Item | Value |
|---|---|
| Sample interface URL | http://XXXX.com/api/callback (configure the corresponding address per application scenario) |
Application Scenario 1 — Reseller integration & development: the service provider pushes real-time printer-status messages to this interface, and the reseller must handle the different message types. The full address is custom-defined by the customer.
Application Scenario 2 — Reseller does not integrate/develop: view the latest printer tasks and status on the service provider's system platform by configuring the callback URL provided by the service provider: https://tprint.colorpark.cn/api/OpenCallBack/printerCallBack
Application Scenario 3 — Value is empty: no callback is pushed and no platform device data is updated.
Callback Result
| Parameter | Data Type | Sample Value | Description |
|---|---|---|---|
printer_id |
string | 500001 |
Printer ID assigned for the print job |
once |
string | 8305 |
Random value sent with each request |
time |
string | 1646790335 |
Timestamp sent with each request |
sign |
string | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c |
Signature |
status |
string | 1 |
Printer status, pushed in sync with the print-task callback. 0: offline; 1: idle; 2: printing; 3: fault; 4: maintenance |
msg |
string | Print finished |
Displays different information based on printer status. 0: offline; 1: idle; 2: printing; 3: fault; 4: maintenance |
notice_time |
string | 2022-07-19 17:08:30 |
Notification time |
Note: The sample value of the
msgfield is written as "Print finished," which does not match the printer-status context — likely a typo. Preserved verbatim as in the source.
If a problem that cannot be resolved occurs during device commissioning, contact the cloud-printing responsible person for troubleshooting. Contact details: Phone: 137-5177-4454 (WeChat same number) Email: info@ColorPark.cn