Third-party platforms send a Start Engraving command to the open platform via the interface (
/api/Printer/startEngrave). The open platform receives it, connects to the device to perform the engraving operation, and synchronously returns the engraving status. When a desktop device requires secondary confirmation for a task, this interface must be called again for the device to complete the task's engraving execution.
Note: In the source text, this note reads: "When the device requires secondary confirmation for a task, call this interface again for the device to complete the task's printing." The word "printing" is inconsistent with the interface topic "engraving" and is likely a typo; preserved verbatim as in the source.
Interface Information
- Endpoint:
https://www.colorpark.cn/api/Printer/startEngrave - 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. |
taskid |
20000196 | string | Yes | Unique ID assigned to the print task. |
Response Result
| Field | Data Type | Example Value | Description |
|---|---|---|---|
code |
string | 0 | Result status code. 0 on success, 1 on failure. |
msg |
string | Successfully sent start printing… | Result description, e.g., Successfully sent start printing…. |
data.taskid |
string | 20000196 | Unique ID of the print task. |
data.printer_id |
string | 500001 | Unique device ID assigned to the printer; each printer is assigned a distinct number. |
Note: The example value of
msgin the response result reads "Successfully sent start printing…", which is inconsistent with the interface topic "engraving" and is likely a typo; preserved verbatim as in the source.
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