通信约定与通用规范

文档版本：1.0（2026-06-13） 编码：UTF-8 · JSON

1. 接口概述

本协议为「Tcp 瑞丰彩局域网协议」，所有查询、打印与进度轮询均通过统一入口 POST /api/app_print 完成。

• 打印机连接约 10 秒 后启动 HTTP 服务，默认端口 8555
• 统一入口 POST /api/app_print，JSON 请求 / JSON 响应
• 支持命令：CMD_ID = 00 01 02 03 04

2. 通信约定

说明：{设备IP} 需替换为实际打印机 IP，不要写死某一台机器的地址；端口默认 8555。

3. 通用请求体

{
  "CMD_ID": "00"
}

所有请求必须包含 CMD_ID；其余字段见各命令说明。

4. 通用响应格式

4.1 成功响应

{
  "CMD_ID": "00",
  "code": 0
}

固定字段：CMD_ID、code（0 = 成功）。各命令附加业务字段见下文。

4.2 失败响应

固定字段：code（-1 = 失败）、msg（失败原因）。能解析到 CMD_ID 时原样回传。

业务失败（HTTP 200）

{
  "CMD_ID": "00",
  "code": -1,
  "msg": "失败原因"
}

请求无法解析（HTTP 400，可能无 CMD_ID）

{
  "code": -1,
  "msg": "CMD_ID 不能为空"
}

注意：业务成败以 JSON 的 code 为准，不要只看 HTTP 状态码。

5. 命令总览