Category: Interface — Embedded Direct-Connect (TCP)
Read Print Progress — use CMD 03 to track the printing process.
What to prepare before starting?
First confirm the internal unit model, firmware, and device IP; the current communication spec uses a local HTTP address and CMD_ID commands.
The category name contains "TCP", but the actual request method follows "Communication Conventions and General Specifications". The call examples here apply only to the embedded protocol.
Next: Compare with Code Example →
Query the board's print progress.
| Item | Content |
|---|---|
| Interface Name | Print Progress |
| Command ID | CMD_ID = 03 |
| Request Method | POST |
| URL | http://{deviceIP}:8555/api/app_print |
| Content Type | application/json |
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| CMD_ID | string | Yes | Fixed "03" |
Request Example
{ "CMD_ID": "03" }Response Parameters
| Name | Type | Description |
|---|---|---|
| CMD_ID | string | "03" |
| code | int | 0 indicates success |
| progress | int | Print progress 0–100; 0 when there is no print job or the job has ended |
Progress Change Rules
- After CMD 01 is accepted and before RIP completes:
progressstays at 0. - After StartPrint is dispatched:
progressincreases with board callbacks. - After printing completes or the session ends:
progressresets to 0.
Response Examples
Printing
{ "CMD_ID": "03", "code": 0, "progress": 35 }No Task / Completed
{ "CMD_ID": "03", "code": 0, "progress": 0 }If the device encounters an unsolvable problem during debugging, contact the cloud-printing owner to troubleshoot and find a solution. Contact details are as follows:
- Phone: 137-5177-4454 (WeChat same number)
- Email: info@ColorPark.cn