瑞丰彩・UV云打印・开放平台

## 如何对接互联网接口
参考以下步骤完成互联网API的调试与使用

### 基本信息
所有的API请求必须使用HTTPS。
请求时不应忽略服务器证书验证的错误，避免被恶意劫持。

###一、软件安装
1、采购UV打印机硬件设备，同时确保设备能正常运行；
2、与技术支持人员获取最新的软件安装工具包，打印机软件和终端软件：
**打印机软件（PrintExp）**：使用网络数据传输连接到打印机，实现喷墨式打印。
**互联网接口打印终端软件**：接口调用后终端软件实时从热文件夹里拉取图片转输给打印机软件。

##### 互联网接口打印终端软件-对接产品分类：

| 网络类型  | 有无回调  | 是否支持货道  | 适用商品类型  | 全/半自动  | 软件名  | 货道数  | 屏幕尺寸（英寸）  | 屏幕方向  | 产品特性  |
| ------------ | ------------ | ------------ |
|  互联网 | 有回调  | 无货道  | 全部通用  | 半自动  | 互联网接口桌面式  | -  | 7、10.1、15.6、24、27、32  | 竖屏、横屏  | 支持不同DIY风格纪念币，色彩鲜艳，需手动确认打印  |
|  互联网 | 有回调  | 有货道  | 吧唧、金币、冰箱贴、纪念币、亚克力板等  | 全自动  | 扫码金币自助机二货道  | 二、三、四  | 7、10.1、15.6、24、27、32  | 竖屏、横屏  | 支持不同DIY风格纪念币，色彩鲜艳，支持自动打印  |

**打印机软件（PrintExp）界面如下**：
1、软件包安装操作流程：双击exe安装包->点击“下一步”->点击“安装”->点击“完成”->弹出“微软常用运行库合集”弹框，点击“下一步”->点击下一步->点击“结束”。
2、安装完界面如下：
![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/document/634153e8a64082ba335f6adb1fe79e406c7ef05c.PNG)

**互联网接口打印终端软件-安装操作流程：**
双击exe安装包->点击“下一步”->点击“安装”->点击“完成”。
![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/document/eb8ecba704010bbb6de233505460a8aa87f7ca08.PNG)

###二、参数准备
####1、生成签名
可参考文档 [生成签名](https://colorpark.cn/admin/guide/document?id=21 "生成签名")
####2、测量物料
1、参考文档，完成测量 [测量物料](https://colorpark.cn/admin/guide/document?id=35 "测量物料")
2、然后按要求完成接口传参调用；
###三、接口调试
可依次完成以下接口调试：
1、 [发送打印任务](https://colorpark.cn/admin/guide/document?id=1 "发送打印任务")；
2、 [开始打印任务](https://colorpark.cn/admin/guide/document?id=3 "开始打印任务")；
3、 [查询打印任务](https://colorpark.cn/admin/guide/document?id=2 "查询打印任务")；
4、 [取消打印任务](https://colorpark.cn/admin/guide/document?id=4 "取消打印任务")；
###四、接收实时回调
用于服务商传送打印实时消息回调到指定服务器，代理商可不配置，也可自定义自服务器的地址。
功能路径：设备列表->详情->回调地址
1.关闭状态：回调地址不生效
2.启动状态：回调地址生效

**回调地址配置：**
场景1、代理商接入开发，服务商往该接口传送打印机状态实时消息，代理商需要对不同的消息进行处理，完整地址由客户自定义。
场景2、代理商不接入开发，在服务商系统平台查看最新打印机任务及状态，配置服务商提供的地址：&#x68;ttps://tprint.colorpark.cn/api/OpenCallBack/printerCallBack
场景3、值为空，不推送回调，不更新任何平台设备数据。

**推送回调数据类型：**
可根据回调字段区分回调类型：
1、[打印任务回调](https://colorpark.cn/admin/guide/document?id=22 "打印任务回调")
2、[打印机状态回调](https://colorpark.cn/admin/guide/document?id=38 "打印机状态回调")

![](https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/document/c99328b7da3bf3e410569b9f4275ee6581c273d3.PNG)

------------

恭喜，你已经完成互联网接口的基本调试，快去对接到你的应用吧

------------

*若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下：
电 话：137-5177-4454【微信同号】
邮 箱：info@ColorPark.cn*

##### *软硬件深度整合的UV云打印服务商  &reg; 瑞丰彩*