云打印開放平臺簡介

中午云是依托移動互聯網的超遠程打印解決方案，包含了設備管理中心、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"}，推送上報地址的可用性測試。

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