消息对接文档 - 米合开放平台

消息推送服务接入指南：
为提高开发者API接口调用效率，增强数据通信的实时性，米合开放平台提供主动推送消息服务。基于消息推送服务，只要相关事件发生，就会把对应的消息实时推送到开发者配置的推送地址。开发者无需通过轮询API来获取相关数据，仅需在接收到消息后解析即可。使用该种数据对接方式可以大大提高API调用效率，减少双方计算资源的浪费。
一、通知方式

1.推送地址是开发者用来接收消息的地址，目前仅支持配置一个地址
2.用户提供调用地址，地址需公网可访问。
二、接收消息
1.消息推送服务通过POST、参数编码为APPLICATION/JSON(输入流)的方式向开发者提供的地址推送消息。由于平台服务端响应超时时间为2s，建议开发者接收到消息后立即返回成功code，再异步去处理自有的业务信息
2.开发者接收到消息后必须返回 {"code":0,"message":"成功"} 通知米合开放平台成功接收，否则会被判定为推送失败，系统会自动进行消息重推。最多重推3次，推送的时间间隔5min。
三、消息体示例

    {
  "clientId": "xxx",
  "sign": "DJALFK3J55LJAL6L6LJDAFJL",
  "data": [
    {
      "companyCode": "xxx",
      "messageId": "dsafa453das453f3da4s3f4das3f54d63asf4da3",
      "messageTag": "orderxxxx",
      "orderCode": "xxx",
      "sourceOrderCode": "xxx",
      "timestamp": 1545434343434
    },
    {
      "companyCode": "xxx",
      "messageId": "dsafa453das453f3da4s3f4das3f54d63asf4da4",
      "messageTag": "orderxxxx",
      "orderCode": "xxx",
      "sourceOrderCode": "xxx",
      "timestamp": 1545434343435
    }
  ]
}

1.目前支持的消息参见api文档：https://bb3v3zffs6.apifox.cn/388865735e0
2.为防止请求被拦截后，参数被恶意篡改，数据根据开发者对接文档的规则进行加签。开发者需要校验clientId是否为自己持有，并校验签名正确后方可使用数据。