### 1.消息說明 開放平臺向接入商的系統實時推送業務變更消息，接入商系統收到消息后，進行相應的處理，實現數據同步，從而滿足接入商系統業務功能。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#2%E6%8E%A8%E9%80%81%E6%96%B9%E5%BC%8F)2.推送方式 為避免接入商輪詢，開放平臺采用推送的方式，以`http post`的形式向商戶指定的回調地址(自行在聚合供應鏈商戶后臺的應用上配置)進行推送。推送的消息數據(Body中除sign以外的部分)會進行消息摘要([詳見簽名規則](簽名規則.md))，接收方收到數據后，需對數據進行驗簽，以保證數據的可靠性。接收方正常處理完消息后，需回執`SUCCESS`，若接收或處理失敗，消息會自動重發(參見生命周期) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#3%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F)3.生命周期 正常情況下，每條消息最多會進行8次通知 (通知的間隔頻率一般是：`立即`,`10s`,`30s`,`1m`,`2m`,`3m`,`4m`,`5m`) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#4%E5%B9%82%E7%AD%89%E5%A4%84%E7%90%86)4.冪等處理 由于網絡原因、接入商系統原因，或接入商系統接收成功但未正常回執等，會觸發消息的重試機制，接收方需要對同一個id的消息多次投遞結果實現冪等。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#5%E6%8E%A8%E9%80%81%E6%95%B0%E6%8D%AE%E6%A0%BC%E5%BC%8F)5.推送數據格式 **請求方式：**`POST` **請求參數** Headers | 參數名稱 | 參數值 | 必填 | 類型 | 備注 | | --- | --- | --- | --- | --- | | Content-Type | application/json | 是 | String | | Body | 名稱 | 類型 | 必須 | 示例值 | 備注 | | --- | --- | --- | --- | --- | | id | java.lang.Long | 是 | 1601051353780715520 | 消息唯一標識 | | pushTime | java.lang.Long | 是 | 1670555403922 | 消息推送時間 | | type | java.lang.String | 是 | life.film.order.status.change | 消息類型 | | data | java.lang.String | 是 | {“orderSubStatus”:“2”,“dbyOrderId”:“1411656131044918722561”,“orderSubStatusName”:“受理中”} | 推送數據 (json字符串) | | sign | java.lang.String | 是 | 21A5C3C007A5998166602C6B1133E47C | 簽名 | 示例 ~~~json { "id":1601051353780715520, "pushTime":1670555403922, "type":"life.film.order.status.change", "data":"{\"orderSubStatus\":\"2\",\"dbyOrderId\":\"1411656131044918722561\",\"orderSubStatusName\":\"受理中\"}", "sign":"21A5C3C007A5998166602C6B1133E47C" } ~~~ > 基于`type`字段值，區分不同的消息類型，各種類型的消息，`data`字段對應的json字符串格式不同 ## [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E6%B6%88%E6%81%AF%E7%B1%BB%E5%9E%8B)消息類型 * * * ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E8%AE%A2%E5%8D%95)訂單 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E8%AE%A2%E5%8D%95%E7%8A%B6%E6%80%81%E5%8F%98%E6%9B%B4)訂單狀態變更 > type:`life.film.order.status.change` * * * **`data`字段對應的json數據格式:** | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | dbyOrderId | String | 1411601121460812906496 | 小象訂單號 | | orderSubStatus | String | 2 | 訂單狀態 | | orderSubStatusName | String | 受理中 | 訂單狀態描述 | **收到消息后的處理方式：** 通過[查詢電影票訂單詳情](H5電影訂單詳情.md)接口，獲取訂單最新的信息，將每個子訂單的最新狀態更新到接入方系統中，結合接入方系統的業務，對不同的狀態做其他處理