# 消息推送说明 ### 一、概述 1. 消息推送是开放平台主动调用开发者服务的一个通道，用于向应用推送订单状态变更、打印机状态变更等消息。开发者需要在应用管理的后台，设置需要监听的消息类型的推送URL，当有该种类型的消息产生时，开发平台会向应用设置的URL发送HTTP POST数据，达到通知应用的目的。 ### 二、推送协议 1. 开放平台以HTTP POST 的方式进行消息推送请求。 2. 开放平台消息推送请求的HTTP Header中的contentType 为“application/x-www-form-urlencoded” 3. 为了防止推送消息被篡改，开放平台进行推送的时候会有简单签名，签名规则见【签名验证规则】，应用需要自行校验消息数据。 4. 应用在消息处理完成后，需要回复HTTP Response的code 200 以及body为{"data":"OK"}，表示此次推送消息接收成功。 5. 推送请求如果3s内没有收到响应头为200响应，平台认为此次推送不成功，不管因为什么原因，平台都会重新发起推送（总推送次数不超过3次（<=3））。 6. 应用收到推送HTTP请求后，必须在3s内完成响应，否则平台认为超时响应，会重复推送，造成双方资源浪费。 7. 应用需要自行处理重复推送造成的消息重复。 8. 为了方便未来的消息内容升级，应用需要兼容处理当前消息中不存在的字段。 9. 应用需要支持推送地址的GET与POST访问，当GET或POST请求访问时，请直接返回{"data":"OK"}，用于推送地址的可用性测试。 ### 三、签名验证规则： 1. 入签参数client_id、client_secret、push_time。 2. 按照client_id、push_time、client_secret排列方式，将相应参数的值进行拼接。 3. 示例：假设client_id的值为A、client_secret的值为B、push_time的值为C，进行拼接后的待签字符串为ACB。 4. 将上一步得到的字符串进行MD5编码，得到sign参数的值。