创建打印任务事件,是用于第三方平台通过接口的方法往开放平台发送打印的图片任务,开放平台接收到打印任务后,会自动派发到对应的设备编号的打印终端软件上。派发打印任务可以离线派发,打印终端上线后就能接收到所有的离线的派发任务。
接口信息
| 参数名 | 参数值 | 参数说明 |
|---|---|---|
| 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