第三方平台通过接口向指定设备发送单个打印任务,开放平台自动派发至该设备终端软件执行。支持离线任务发送,终端上线后自动接收并执行。全自助设备调用时需携带货道信息,设备自动完成指定货道商品打印。
注:当使用的全自助设备,将调用此接口,参数带有货道信息,设备将自动完成指定货道商品的打印操作,桌面收单软件新增:打印模式,墨水模式(需升级收单软件为最新版本V3.5.1)。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/Printer/mulPrint |
| 请求方式 | POST |
请求参数
| 参数名 | 参数值(示例) | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节 |
| order_id | 164679033555822 | string | 是 | 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符 |
| name | 手机壳 | string | 是 | 第三方平台的商品名称,由第三方平台生成,最大接受 32 位字符 |
| file | https://img.colorpark.cn/api/render/36531651306594235.png | string | 是 | 详细说明查看下方【参数说明】 |
| file_bgc | https://img.colorpark.cn/back/6167751754907026663.png | string | 可选 | 打印进度条显示的背景特效图,网址最大接受 255 位字符,支持 jpg、png,推荐使用 jpg、png,仅支持部分机型,可与技术人员确认 |
| width | 185 | string | 是 | 打印的图片宽度,单位为 mm |
| height | 140 | string | 是 | 打印的图片高度,单位为 mm |
| left | 0 | string | 是 | 打印起点的左边距,单位为 mm |
| top | 0 | string | 是 | 打印起点的上边距,单位为 mm |
| channel_type | 1 | string | 可选 | 货道放置的币种,如果两个货道都放同一种币,这里为 1,如果两个货道放两种不同的币,这里为 2 |
| channel | 1 | string | 可选 | 纪念币的货道,如果是 1 货道这里传 1,如果是 2 货道这里为 2,如果两个货道放同一种币,可以保持一直为 1 |
| ink_mode | 0 | int | 可选 | 查看下方【墨水模式-明细】ink_mode 注解 |
| ink_item | [{"code":"W","layer":1},{"code":"CMYK","layer":1}] | string | 可选 | 详细查看下方【墨水项目-明细】ink_item 注解 |
| is_format_conversion | 0 | string | 可选 | 默认 0 原文件打印,1 原文件转换为图片格式后再打印 |
| callback | http://www.abc.com/api/callback | string | 可选 | 第三方系统用于接收打印通知的回调地址,如开始打印通知、完成打印通知、取消打印通知、打印故障通知 |
请求参数(多任务合并打印,限机型)
注:需要不同商品订单同时打印,则需要用以下参数,第一次调用需联系官方添加设备治具。可以通过调用接口【查询指定治具的商品】获取商品标识【unique】。
| 参数名 | 参数值(示例) | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节 |
| order_id | 164679033555822 | string | 是 | 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符 |
| name | 手机壳 | string | 是 | 第三方平台的商品名称,由第三方平台生成,最大接受 32 位字符 |
| file | https://img.colorpark.cn/api/render/36531651306594235.png | string | 是 | 详细说明查看下方【参数说明】 |
| file_bgc | https://img.colorpark.cn/back/6167751754907026663.png | string | 可选 | 打印进度条显示的背景特效图,网址最大接受 255 位字符,支持 jpg、png,推荐使用 jpg、png,仅支持部分机型,可与技术人员确认 |
| is_merge | 1 | string | 是 | 是否是合并订单,0:不是 1:是合并打印订单 |
| unique | RefrigeratorMagnet | string | 是 | 商品唯一标识 |
| quantity | 1 | string | 是 | 当前订单商品打印数量 |
| ink_mode | 0 | int | 可选 | 查看下方【墨水模式-明细】ink_mode 注解 |
| ink_item | [{"code":"W","layer":1},{"code":"CMYK","layer":1}] | string | 可选 | 详细查看下方【墨水项目-明细】ink_item 注解 |
| callback | http://www.abc.com/api/callback | string | 可选 | 第三方系统用于接收打印通知的回调地址,如开始打印通知、完成打印通知、取消打印通知、打印故障通知 |
返回结果
| 字段 | 数据类型 | 参数值(示例) | 参数说明 |
|---|---|---|---|
| code | string | 0 | 返回结果状态码,成功时为 0,失败时为 1 |
| msg | string | 提交成功 | 返回结果描述,如:提交成功 |
| data.taskid | string | 20000196 | 打印任务的唯一编号 |
| data.order_id | string | 164679033555822 | 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符 |
| data.status | string | 0 | 打印任务状态,0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障 |
callback 回调通知
请求方式:POST
请求参数:
| 参数 | 类型 | 示例 | 说明 |
|---|---|---|---|
| type | string | printing | printing:打印中,finish:打印完成,cancel:取消打印,pause:暂停打印,failure:打印失败,shipped:出货完成 |
| taskid | int | 10041 | 任务 ID |
| printer_id | int | 1000926 | 设备编号 |
| once | int | 0254 | 随机数 |
| time | int | 1778048444 | 时间 |
| sign | string | 06caec435ebbf494e8ed73fdc5daa0a8 | 签名 |
| order_id | string | 1844398 | 订单 ID |
| status | string | 1 | 打印状态:1-打印中 2-打印完成 3-取消打印 4-暂停打印 5-打印失败 6-出货完成 |
| msg | string | 打印中 | 提示 |
墨水项目-明细(限机型)
参数说明:code:对应墨水项目-标识,layer:打印层数
| 标识(ink_mode) | 名称 | 参数(ink_item) |
|---|---|---|
| 0 | CMYK | [{ "code": "W", "layer": 1 }] |
| 1 | W>CMYK | [{ "code": "W", "layer": 1 },{ "code": "CMYK", "layer": 1 }] |
| 2 | 专色 | [{ "code": "P", "layer": 1 }] |
| 3 | 白色 | [{ "code": "W", "layer": 1 }] |
| 4 | CMYK>W | [{ "code:": "CMYK", "layer": 1 },{ "code:": "W", "layer": 1 }] |
| 13 | 浮雕 | [{"code":"W","layer":8},{"code":"CMYK","layer":1}] |
| 15 | 食品雕刻 | [{"code":"CMYK","layer":1},{"code":"S", "layer":1}] |
墨水项目-标识(限机型)
| 标识 | 名称 | 默认值 | 最小值 | 最大值 |
|---|---|---|---|---|
| W | 白色 | 1 | 1 | 8 |
| CMYK | 彩墨 | 1 | 1 | 1 |
| V | 光油 | 1 | 1 | 1 |
| S | 描边 | 0 | 1 | 1 |
| P | 专色 | 0 | 0 | 1 |
墨水项目-参数说明(浮雕与雕刻场景(限机型))
浮雕打印:
参数参考:
ink_mode=13,
ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/tmp/2026/09/0c94cf9aa93dd5bf10acda49474c72cddf8452e1_3203.tif,
https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
参数注释:
ink_item:13(参考墨水项目-明细)
ink_model:[{"code":"W","layer":8}((第一遍灰度图打印白墨8倍),{"code":"CMYK","layer":1}] (第二遍打印原图彩色1倍打印)
file:提供2张图(必须),第一张是灰度图,第二张是原图,用英文逗号分隔
-----------------------------------------------------------
浮雕打印(自动合成):
参数参考:
ink_mode=13,
ink_item=[{"code":"W","layer":8},{"code":"CMYK","layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
参数注释:
ink_item:13(参考墨水项目-明细);
ink_model:[{"code":"W","layer":8}(第一遍灰度图打印白墨8倍,灰度图由开放平台生成),{"code":"CMYK","layer":1}](第二遍打印原图彩色1倍打印);
file:提供1张图,需要转成浮雕的原图地址;
-----------------------------------------------------------
食品雕刻:
参数参考:
ink_item=15
ink_model=[{"code":"CMYK","layer":1},{"code":"S", "layer":1}]
file=https://rfccrm.colorpark.cn/ai_colorpark/render/print/2026/09/16/1000945/0c94cf9aa93dd5bf10acda49474c72cddf8452e1.png
参数注释:
ink_mode:15(参考墨水项目-明细)
ink_model:{"code":"CMYK","layer":1}(彩色打印,layer:默认值1){"code":"S", "layer":1}(layer:0-不描边 1-描边1个像素)
file:提供1张图,需要雕刻的原图地址;
-----------------------------------------------------------
其他打印:
ink_model,ink_item 传参参考【 墨水项目-明细】
file=需要打印的图片网址,图片由第三方平台生成,网址最大接受 255 位字符,支持 jpg、png、tif,推荐使用 jpg、png
若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下: 电 话:137-5177-4454【微信同号】 邮 箱:info@ColorPark.cn