设备控制

KIC设备控制接口支持对设备的远程操作，如远程重启、清洗喷头、打印测试页等设备管控操作。

自定义蜂鸣器发声接口 API

用于远程调用设备蜂鸣器进行“嘀嘀”发声，设备需要在线。

POST /api/control/buzz

• 请求参数（JSON Body）：

名称	类型	必选	说明
client_uuid	String	是	设备UUID
buzz	Integer Array	是	嘀声时长，单位：毫秒（数组内每个数值代表每次发声的时长 ）
gap	Integer	否	每次嘀声之间的间隔时长，单位：毫秒

• 响应参数（JSON Body）:

名称	类型	必选	说明
code	Integer	是	状态码
msg	String	是	状态描述
data	Null	是	响应数据（无）

• 成功示例：

HTTP Status 200

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• 失败示例：

HTTP Status 200

{
  "code": 30002,
  "msg": "设备不存在",
  "data": null
}

查看全部状态码

重启设备接口 API

用于在异常情况下强制远程重启盒子设备，设备需要在线。

POST /api/control/reboot

• 请求参数（JSON Body）：

名称	类型	必选	说明
client_uuid	String	是	设备UUID

• 响应参数（JSON Body）:

名称	类型	必选	说明
code	Integer	是	状态码
msg	String	是	状态描述
data	Null	是	响应数据（无）

• 成功示例：

HTTP Status 200

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• 失败示例：

HTTP Status 200

{
  "code": 30002,
  "msg": "设备不存在",
  "data": null
}

查看全部状态码

清洗打印机喷头接口 API

用于在喷墨打印机在喷头堵塞时的远程喷头清洗维护，设备需要在线。

执行完成后可调用 打印喷嘴检查页接口确认清洗效果。

提示

只有支持严格模式的喷墨打印机支持此操作

POST /api/control/head_clean

• 请求参数（JSON Body）：

名称	类型	必选	说明
client_uuid	String	是	设备UUID

• 响应参数（JSON Body）:

名称	类型	必选	说明
code	Integer	是	状态码
msg	String	是	状态描述
data	Null	是	响应数据（无）

• 成功示例：

HTTP Status 200

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• 失败示例：

HTTP Status 200

{
  "code": 30002,
  "msg": "设备不存在",
  "data": null
}

查看全部状态码

大墨量清洗打印机喷头接口 API

用于在喷墨打印机在喷头严重堵塞（普通清洗3-5次以上无法疏通）时的远程喷头清洗维护，设备需要在线。

执行完成后可调用 打印喷嘴检查页接口确认清洗效果。

注意

该操作需要消耗大量的墨水，24小时内建议只执行一次该操作。

提示

只有支持严格模式的喷墨打印机支持此操作

POST /api/control/power_ink_flush

• 请求参数（JSON Body）：

名称	类型	必选	说明
client_uuid	String	是	设备UUID

• 响应参数（JSON Body）:

名称	类型	必选	说明
code	Integer	是	状态码
msg	String	是	状态描述
data	Null	是	响应数据（无）

• 成功示例：

HTTP Status 200

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• 失败示例：

HTTP Status 200

{
  "code": 30002,
  "msg": "设备不存在",
  "data": null
}

查看全部状态码

打印喷嘴检查页接口 API

用于打印喷嘴检查页，设备需要在线。

提示

只有支持严格模式的喷墨打印机支持此操作

执行前请放置好A4普通纸张

POST /api/control/nozzle_check

• 请求参数（JSON Body）：

名称	类型	必选	说明
client_uuid	String	是	设备UUID

• 响应参数（JSON Body）:

名称	类型	必选	说明
code	Integer	是	状态码
msg	String	是	状态描述
data	Null	是	响应数据（无）

• 成功示例：

HTTP Status 200

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• 失败示例：

HTTP Status 200

{
  "code": 30002,
  "msg": "设备不存在",
  "data": null
}

查看全部状态码