创建打印任务事件

最后更新:2026-09-22 15:55:35

创建打印任务事件,是用于第三方平台通过接口的方法往开放平台发送打印的图片任务,开放平台接收到打印任务后,会自动派发到对应的设备编号的打印终端软件上。派发打印任务可以离线派发,打印终端上线后就能接收到所有的离线的派发任务。

接口信息

参数名 参数值 参数说明
IP 192.168.127.11 局域网内使用对应的 IP
端口 63333 固定的端口
连接方式 TCP 采用 TCP 的长连接方式
编码格式 UTF8 收发数据全部采用 UTF8 编码
数据格式 json 数据发送与接收都采用 Json 格式

请求示例

{"event":"01","order_id":"20000196","name":"银币","file":"C:/images/11.jpg","width":"38","height":"38","left":"0","top":"0","white_ink":"0","channel_type":"1","channel":"1"}

响应结果

{"event":"01","code":"0","msg":"成功","task_id":"10000002","order_id":"20000196","status":"0"}

注:原始资料的响应示例中 order_id 与 status 之间缺少逗号("order_id":"20000196""status":"0"),此处按正确 JSON 格式补全,字段内容与原文一致。

请求参数

参数名 参数值(示例) 数据类型 必填项 参数说明
event 01 string 是 01 代表发送打印任务创建事件
order_id 20000196 string 是 调用方的订单编号,由调用方自定义,支持 32 位以内的字符串,如 20000196
name 银币 string 是 商品名称,如 银币
file C:/images/11.jpg string 是 支持本地的图片路径、线上的 URL 地址、base64,如 C:/images/11.jpg 或者 https://img.colorpark.cn/api/render/36531651306594235.png 或者 /9j/4AAQSkZJRgABAQAAAQABAAD/4QF0q0YT0P//Z(支持 jpg、png、tif 格式,推荐使用 jpg、png)
width 38 string 是 需要打印的图片宽度,单位 mm
height 38 string 是 需要打印的图片高度,单位 mm
left 0 string 是 需要打印的图片左边距,单位 mm
top 0 string 是 需要打印的图片上边距,单位 mm
white_ink 0 string 是 是否需要白墨,0 为不打白墨,1 为打印白墨
channel_type 1 string 否 当前机器货道的种类,货道只放一种币值为 1,放两种币的值为 2
channel 1 string 否 当前订单的金币所在货道,比如金币 A 放在 1 货道,金币 B 放在 2 货道,打印金币 A 时值为 1,打印金币 B 时值为 2,如果两个货道只放一种币,就保持传 1 即可

返回结果

参数名 参数值(示例) 数据类型 参数说明
event 01 string 01 代表发送打印任务创建事件
code 0 string 返回结果状态码,成功时为 0,失败时为 1
msg 成功 string 返回结果描述,如:提交成功
task_id 10000002 string 分配给打印任务的唯一编号,若订单创建失败返回调用方提供的 task_id,若订单创建成功由服务商提供
order_id 20000196 string 订单编号,调用方定义
status 0 string 打印任务状态,0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障

若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下:

  • 电 话:137-5177-4454【微信同号】
  • 邮 箱:info@ColorPark.cn
软硬件深度整合的UV云打印服务商 ® 瑞丰彩