消息回调服务说明
一.什么是消息回调?
消息推送是货拉拉开放平台为提高应用API调用效率而推出的一种消息回调服务,推送包括”订单状态+司机账单“信息。基于该推送服务,应用获取货拉拉数据不需再不停轮询API,仅需在接收到货拉拉推送的消息时调用API获取即可,大大提高API调用效率,节省了服务器性能
二.哪些业务能支持回调?
【货拉拉APP】业务:支持回调
【货拉拉企业版APP】业务:暂不支持回调
三.通知事件类型及场景
1.订单状态变更事件。当订单状态变更后,我们将发出订单状态通知事件
2.司机账单事件。当司机添加了账单,修改了账单,客服处理完申诉账单,我们将发出账单通知事件
四.通知报文结构说明
货拉拉统一定义发出的通知报文结构,请开发者按照货拉拉通知报文格式进行解析,通知报文结构如下:
五.是否需要开发者响应推送?
需开发者应用通过指定json数据格式,指定参数值进行response响应。
如果开发者不响应/响应数据格式不正确/响应值不正确,则按照响应失败处理
响应失败重推策略:当消息发出后,如果未接收到同步响应(含响应失败的场景),则在60s后,重推消息一次。如果还是未接收到同步响应,则放弃重推
response响应示例
{
"serial_no":"xxxxx" //值来源于通知消息中参数 serial_no
}