云打印设备
云打印体验
行业案例
解决方案
OpenAPI
关于我们
开放平台
beta
中文
可以
简体中文
English
什么是云打印
客户端应用
核心概念
测量物料
接口|互联网
接口|局域网
接口|AI 智能
接口|TCP局域网
-
分享
> 创建打印任务事件,是用于第三方平台通过接口的方法往开放平台发送打印的图片任务,开放平台接收到打印任务后,会自动派发到对应的设备编号的打印终端软件上。派发打印任务可以离线派发,打印终端上线后就能接收到所有的离线的派发任务。 #### 接口信息 | 参数名 | 参数名 | 参数说明 | | ------------ | ------------ | ------------ | | IP | 127.0.0.1 | 局域网内使用对应的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"} | #### 请求参数 | 参数名 | 参数值(示例) | 数据类型 | 必填项 | 参数说明 | | ------------ | ------------ | ------------ | ------------ | | 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) | | file_ex | .jpg | string | 否| 如果是base64则带上这个参数,否则不需要,注意文件拓展名是.jpg 而不是jpg点要带上,否则无法处理 | | 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 | 分配给打印任务的唯一编号 | | order_id | 20000196 | string | 订单编号,调用方定义 | | status | 0 | string | 打印任务状态,0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障 | ------------ *若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下: 电 话:137-5177-4454【微信同号】 邮 箱:info@ColorPark.cn* ##### *软硬件深度整合的UV云打印服务商 ® 瑞丰彩*
关于TCP接口
对接指南
打印机待打印订单删除事件
发送心跳包事件
创建打印任务
取消打印任务
打印任务状态回调事件
打印机状态回调事件
打印机缺墨回调事件