# 消息推送 消息推送是開放平臺主動調用開發者服務的一個通道，用于向應用推送訂單狀態變更、打印機狀態變更等消息。開發者需要在應用管理的后臺，設置需要監聽的消息類型的推送ＵＲＬ，當有該種類型的消息產生時，開發平臺會向應用設置的URL發送HTTP POST數據，達到通知應用的目的。 ### 推送協議 當有應用訂閱的消息事件發生時，開放平臺會通過請求應用設置的消息推送地址進行消息的投遞。 1. 開放平臺以HTTP POST 的方式進行消息推送請求。 2. 開放平臺消息推送請求的HTTP Header中的contentType 為“application/x-www-form-urlencoded” 3. 為了防止推送消息被篡改，開放平臺進行推送的時候會有簡單簽名，簽名規則見【[簽名規則](callback/signrule.md)】，應用需要自行校驗消息數據。 4. 應用在消息處理完成后，需要回復HTTP Response的code 200 以及body為{"data":"OK"}，表示此次推送消息接收成功。 5. 推送請求如果3s內沒有收到響應頭為200響應，平臺認為此次推送不成功，不管因為什么原因，平臺都會重新發起推送（總推送次數不超過3次（<=3））。 6. 應用收到推送HTTP請求后，必須在3s內完成響應，否則平臺認為超時響應，會重復推送，造成雙方資源浪費。 7. 應用需要自行處理重復推送造成的消息重復。 8. 為了方便未來的消息內容升級，應用需要兼容處理當前消息中不存在的字段。 9. 應用需要支持推送地址的GET訪問，當GET請求訪問時，請直接返回{"data":"OK"}，用于推送地址的可用性測試。 ### cmd cmd的識別標示，用于業務判斷 ### 所需參數 |標 識|描 述| |----|----| |oauth_finish|打印完成狀態推送| |oauth_request| 按鍵請求推送 僅支持K2S、K3S| |oauth_printStatus|打印機實時狀態推送| |oauth_getOrder|接單拒單狀態推送| |oauth_printMenu|應用菜單上報推送|