| 项目 |
内容 |
| 接口名称 |
打印 |
| 命令标识 |
CMD_ID = 01 |
| 请求方式 |
POST |
| URL |
http://{设备IP}:8555/api/app_print |
| 内容类型 |
application/json |
请求参数
| 名称 |
类型 |
必填 |
说明 |
| CMD_ID |
string |
是 |
固定 "01" |
| IMG_URL |
string |
是 |
图片地址，由打印机读取或下载（不是手机/电脑本机路径）。两种模式：1. file：打印机本地文件，如 file:///opt/jobs/a.png（提交时文件必须已在打印机上）；2. http / https：远程地址，打印机自行下载；URL 必须是打印机网络能访问的 |
| WIDTH |
number |
是 |
物理宽度（mm） |
| X_MARGIN |
number |
否* |
X 白边 mm；省略时默认 0 |
| Y_MARGIN |
number |
否* |
Y 白边 mm；省略时默认 0 |
| mode |
int |
否* |
色彩/打印模式，见下表；省略时默认 5（仅彩色） |
* 省略时使用默认值。
mode 取值
| mode |
说明 |
| 1 |
白彩 |
| 2 |
彩白 |
| 3 |
彩白彩 |
| 4 |
直喷白 |
| 5 |
仅彩色（默认） |
请求示例
{ "CMD_ID": "01", "IMG_URL": "http://192.168.1.20:8080/jobs/a.png", "WIDTH": 100 }
{ "CMD_ID": "01", "IMG_URL": "file:///opt/jobs/a.png", "WIDTH": 100, "X_MARGIN": 0, "Y_MARGIN": 0, "mode": 5 }
响应参数
| 名称 |
类型 |
说明 |
| CMD_ID |
string |
"01" |
| code |
int |
0 表示任务已受理 |
| msg |
string |
提示信息 |
响应示例
受理成功
{ "CMD_ID": "01", "code": 0, "msg": "打印指令下发成功" }
受理失败
{ "CMD_ID": "01", "code": -1, "msg": "文件不存在" }
{ "CMD_ID": "01", "code": -1, "msg": "设备忙碌" }
{ "CMD_ID": "01", "code": -1, "msg": "设备未联机" }
受理校验流程
受理前依次校验：文件（本地路径须存在）→ 设备（须联机且非忙碌）。任一失败立即返回，不进入 RIP/打印流程。
注意：成功响应仅表示任务已受理。打印进度轮询 CMD_ID=03；任务状态轮询 CMD_ID=00, TYPE=2。