Category: Interface — Embedded Direct-Connect (TCP)
Query the remaining percentage of each color ink cartridge; data comes from the board's GetInkDisPlay.
| Item | Content |
|---|---|
| Interface Name | Ink Status |
| Command ID | CMD_ID = 04 |
| 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 "04" |
Request Example
{ "CMD_ID": "04" }Response Parameters
| Name | Type | Description |
|---|---|---|
| CMD_ID | string | "04" |
| code | int | 0 indicates success |
| data | array | Ink channel list, see table below |
data[] Element
| Name | Type | Description |
|---|---|---|
| name | string | Channel name: C / Y / K / M / W, etc. |
| percent | int | Remaining percentage 0–100; -1 if unknown |
Response Example
{
"CMD_ID": "04",
"code": 0,
"data": [
{ "name": "C", "percent": 80 },
{ "name": "Y", "percent": 65 },
{ "name": "K", "percent": 12 },
{ "name": "M", "percent": 90 },
{ "name": "W", "percent": 40 }
]
}Note: When the device is not connected or the SDK interface is unavailable,
datamay be an empty array[], butcode: 0is still returned.
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