云打印開放平臺簡介

中午云是依托移動互聯(lián)網(wǎng)的超遠(yuǎn)程打印解決方案，包含了設(shè)備管理中心、API、云打印設(shè)備等，被用戶廣泛使用的產(chǎn)品。提供了面向互聯(lián)網(wǎng)開放的API接口，配置開源、有效的實現(xiàn)了打印系統(tǒng)和應(yīng)用開發(fā)者之間的對接，幫助用戶和開發(fā)者方便地使用云打印的架構(gòu)和功能。定位于國內(nèi)智能云打印平臺，可以運(yùn)用于外賣網(wǎng)、酒店、超市、餐廳、O2O等。傳統(tǒng)打印機(jī)作為電腦的一個配件，必須連接電腦才能使用。而中午云通過網(wǎng)絡(luò)傳輸數(shù)據(jù)，不需要連接電腦，就可以接受打印請求，實現(xiàn)異地打印。

同時，開放平臺將通過提供一系列非業(yè)務(wù)性的，例如測試工具、API調(diào)試工具、服務(wù)監(jiān)控告警、日志分析統(tǒng)計等解決方案，讓開發(fā)者專注于業(yè)務(wù)系統(tǒng)的開發(fā)，降低開發(fā)者的接入成本。

概念和術(shù)語

名詞定義：

• 開放平臺： 指由中午科技所擁有并且經(jīng)營的 http://cloud.zhongwuyun.com 網(wǎng)站及相關(guān)頁面，簡稱“開放平臺”。
• 開發(fā)者： 指按照開放平臺流程經(jīng)注冊、登錄，通過技術(shù)文檔進(jìn)行軟件開發(fā)的自然人、法人或者組織。開發(fā)者通過開放平臺提供的技術(shù)文檔進(jìn)行軟件開發(fā)，服務(wù)自身或者其他客戶。
• 應(yīng)用： 指由開發(fā)者通過開放平臺提供的技術(shù)文檔所開發(fā)的應(yīng)用程序或者軟件服務(wù)。
• 商戶： 指在中午云上注冊的自然人、法人或組織結(jié)構(gòu)擁有者，具有對中午云打印機(jī)的管理權(quán)限。
• 終端號： 商戶在中午云上所綁定的云打印機(jī)，以及云打印機(jī)的唯一標(biāo)識數(shù)字。需要注意的是，商戶和打印機(jī)是一對多的關(guān)系，即一個商戶可以擁有和管理多臺云打印機(jī)。
• appid： 應(yīng)用的身份標(biāo)識，全局唯一的一個字符串,應(yīng)用的唯一標(biāo)識，在創(chuàng)建應(yīng)用時分配
• appsecret： 應(yīng)用的私鑰，一般配合應(yīng)用的client_id一起成對使用，用來驗證應(yīng)用的合法性。
• OpenAPI： 開放平臺為第三方應(yīng)用接入提供的編程接口。具體接口說明，參見API文檔列表。

動詞解釋：

• 調(diào)用： 開發(fā)者所開發(fā)的應(yīng)用，想要使用接口，則必須經(jīng)過請求訪問，請求發(fā)起的操作稱之為調(diào)用。
• 推送： 開放平臺向應(yīng)用發(fā)送“打印狀態(tài)變化”、“打印機(jī)狀態(tài)變化”等消息，稱之為向應(yīng)用推送消息。

第一步：入駐成為開發(fā)者

首先填寫申請表單成為開放平臺開發(fā)者，點擊 申請加入 (http://cloud.zhongwuyun.com/api) 填寫對應(yīng)的信息。如果未登錄，請登錄賬號后方可申請加入，請直接使用中午云賬號登錄開放平臺，完成開發(fā)者入駐。

第二步：創(chuàng)建應(yīng)用

申請入駐成功后就可以進(jìn)入開放平臺開始使用了，入口點擊開始使用開放平臺(http://cloud.zhongwuyun.com/api）。
查看API信息 --> 申請 --> 申請成功

第三步：接口開發(fā)

應(yīng)用申請通過之后可獲取查看API信息(http://cloud.zhongwuyun.com/api)中查看應(yīng)用的appid 和 appsecret ，然后閱讀API文檔進(jìn)行開發(fā)使用。

其中消息推送目前有兩種支持：

1.打印完成狀態(tài)推送

2.設(shè)備狀態(tài)推送

在查看API信息(http://cloud.zhongwuyun.com/api)中查看應(yīng)用的appid 和 appsecret，設(shè)置應(yīng)用推送地址。

地址設(shè)置要求滿足兩點需要：

1.請求推送地址填寫必須以http://或https://開頭的地址。

2.推送地址需要支持GET訪問，當(dāng)GET請求訪問時，請直接返回{"retMsg":"success"}，推送上報地址的可用性測試。

設(shè)置好推送地址后有開啟和關(guān)閉按鈕，如果推送的內(nèi)容失敗開關(guān)會顯示感嘆號異常提醒。