The third-party platform sends a start-printing command to the open platform via a TCP interface. Upon receipt, the platform connects to the printer to execute the print operation and returns the print status synchronously. Note: when a device requires secondary confirmation for a task, this interface must be called again for the device to complete the task's printing.
Note: When a task requires secondary confirmation, call this interface again for the device to complete the task's printing.
Interface Information
| Parameter | Sample Value | Description |
|---|---|---|
| IP | 127.0.0.1 |
Use the corresponding IP within the LAN |
| Port | 63333 |
Fixed port |
| Connection | TCP | Uses a long-lived TCP connection |
| Encoding | UTF8 | All transmitted/received data uses UTF-8 |
| Data format | json | Both data sending and receiving use JSON format |
Request example:
{"event":"04","task_id":"20000196","print_task_id":"20000256"}Response example:
{"event":"01","code":"0","msg":"Success","task_id":"10000002","order_id":"20000196","status":"0"}Note: The source response example omits a comma between
"order_id":"20000196"and"status":"0"(i.e.,"20000196""status":"0"), making it invalid JSON. The corrected version above adds the missing comma; the original values are preserved verbatim.
Request Parameters
| Parameter | Sample Value | Data Type | Required | Description |
|---|---|---|---|---|
event |
04 |
string | Yes | 04 = execute print command |
task_id |
20000196 |
string | Yes | Identifier for the current command, custom-defined by the caller; supports strings up to 32 characters |
print_task_id |
20000256 |
string | Yes | The taskid returned when placing the order. If left empty or non-existent, printing starts from the 1st task |
Response Result
| Parameter | Sample Value | Data Type | Description |
|---|---|---|---|
event |
04 |
string | 04 = execute print command |
code |
0 |
string | Result status code: 0 on success, 1 on failure |
msg |
Success |
string | Result description, e.g., "Submitted successfully" |
task_id |
10000002 |
string | Identifier for the current command, custom-defined by the caller; supports strings up to 32 characters |
status |
0 |
string | Print task status: 0: start printing; 1: another task is printing; 4: print fault |
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