Third-party platforms call the remote Clean Printhead interface (
/api/Printer/cleanHead) to send a command to the open platform, which forwards it to the printer terminal software on the designated device to automatically run the printhead-cleaning routine — used to resolve printhead clogging, missing-nozzle lines, and similar issues. The interface synchronously returns the operation status. Note that the latest version of the cloud-printing client must be upgraded or installed to use this feature.
Note: Upgrade or install the latest version of the cloud-printing client to use the current feature (confirm the client version with the official technical team).
Interface Information
- Endpoint:
https://www.colorpark.cn/api/Printer/cleanHead - Method: POST
Request Parameters
| Parameter | Example Value | Data Type | Required | Description |
|---|---|---|---|---|
printer_id |
500001 | string | Yes | Unique device ID assigned to the printer; each printer is assigned a distinct number. |
once |
8305 | string | Yes | Random value used when generating the signature (nonce). |
time |
1646790335 | string | Yes | Timestamp used when generating the signature. |
sign |
9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | Generated signature. For the generation method, please refer to the Bottom-Level Methods [Basic Support] → Generate Signature section. |
Response Result
| Field | Data Type | Example Value | Description |
|---|---|---|---|
code |
string | 0 | Result status code. 0 on success, 1 on failure. |
msg |
string | Push success | Result description, e.g., Push success. |
printer_id |
string | 500001 | Unique device ID assigned to the printer; each printer is assigned a distinct number. |
If a device encounters an unsolvable problem during commissioning, contact the cloud-printing lead to troubleshoot and find a solution. Contact details: Phone: 137-5177-4454 (WeChat same number) Email: info@ColorPark.cn