云打印开放平台简介

中午云是依托移动互联网的超远程打印解决方案，包含了设备管理中心、API、云打印设备等，被用户广泛使用的产品。提供了面向互联网开放的API接口，配置开源、有效的实现了打印系统和应用开发者之间的对接，帮助用户和开发者方便地使用云打印的架构和功能。定位于国内智能云打印平台，可以运用于外卖网、酒店、超市、餐厅、O2O等。传统打印机作为电脑的一个配件，必须连接电脑才能使用。而中午云通过网络传输数据，不需要连接电脑，就可以接受打印请求，实现异地打印。

同时，开放平台将通过提供一系列非业务性的，例如测试工具、API调试工具、服务监控告警、日志分析统计等解决方案，让开发者专注于业务系统的开发，降低开发者的接入成本。

概念和术语

名词定义：

• 开放平台： 指由中午科技所拥有并且经营的 http://cloud.zhongwuyun.com 网站及相关页面，简称“开放平台”。
• 开发者： 指按照开放平台流程经注册、登录，通过技术文档进行软件开发的自然人、法人或者组织。开发者通过开放平台提供的技术文档进行软件开发，服务自身或者其他客户。
• 应用： 指由开发者通过开放平台提供的技术文档所开发的应用程序或者软件服务。
• 商户： 指在中午云上注册的自然人、法人或组织结构拥有者，具有对中午云打印机的管理权限。
• 终端号： 商户在中午云上所绑定的云打印机，以及云打印机的唯一标识数字。需要注意的是，商户和打印机是一对多的关系，即一个商户可以拥有和管理多台云打印机。
• appid： 应用的身份标识，全局唯一的一个字符串,应用的唯一标识，在创建应用时分配
• appsecret： 应用的私钥，一般配合应用的client_id一起成对使用，用来验证应用的合法性。
• OpenAPI： 开放平台为第三方应用接入提供的编程接口。具体接口说明，参见API文档列表。

动词解释：

• 调用： 开发者所开发的应用，想要使用接口，则必须经过请求访问，请求发起的操作称之为调用。
• 推送： 开放平台向应用发送“打印状态变化”、“打印机状态变化”等消息，称之为向应用推送消息。

第一步：入驻成为开发者

首先填写申请表单成为开放平台开发者，点击 申请加入 (http://cloud.zhongwuyun.com/api) 填写对应的信息。如果未登录，请登录账号后方可申请加入，请直接使用中午云账号登录开放平台，完成开发者入驻。

第二步：创建应用

申请入驻成功后就可以进入开放平台开始使用了，入口点击开始使用开放平台(http://cloud.zhongwuyun.com/api）。
查看API信息 --> 申请 --> 申请成功

第三步：接口开发

应用申请通过之后可获取查看API信息(http://cloud.zhongwuyun.com/api)中查看应用的appid 和 appsecret ，然后阅读API文档进行开发使用。

其中消息推送目前有两种支持：

1.打印完成状态推送

2.设备状态推送

在查看API信息(http://cloud.zhongwuyun.com/api)中查看应用的appid 和 appsecret，设置应用推送地址。

地址设置要求满足两点需要：

1.请求推送地址填写必须以http://或https://开头的地址。

2.推送地址需要支持GET访问，当GET请求访问时，请直接返回{"retMsg":"success"}，推送上报地址的可用性测试。

设置好推送地址后有开启和关闭按钮，如果推送的内容失败开关会显示感叹号异常提醒。