# 2.1.3 HTTP异步通知
为了及时将自贩机事件(例如开关门结果,硬件异常警报,硬件状态)和购物信息(例如购物结果)等信息及时通知第三方,平台会将相关内容通过HTTP回调的方式通知第三方系统,第三方系统需要接受处理,并按照文档规范返回。
# 回调通知类型
- 商品变更通知
- 广告变更通知
- 开关门通知
- 自贩机运营警报
- 购物结算
- 素材审核通知
- 新品申请审核通知
- 硬件状态通知
简单购平台当前支持以上八种通知类型,第三方系统需要对每一种通知类型提供一个回调地址,并告知简单购平台进行配置。 在稍后的文档中,将使用
# 回调请求说明
- 所有的通知请求都为
POST方法 - 通知请求会在header中携带key为
Authorization的签名,用于安全校验,生成规则请参考2.1.1 HTTP接口。 - 第三方系统处理完成之后,需要返回
success字符串,标识处理完成。
# 注意事项
- 同样的通知可能会多次发送给第三方系统,第三方系统必须能够及时正确处理重复的通知。
- 第三方系统收到结果通知,需要在5秒内返回应答报文,否则平台认为通知失败,后续会重复发送通知。
- 如果平台收到的应答不符合规范或超时,会判定本次通知失败,并按
/0s/10s/30m/1m/2m/3m/4m/5m/6m/7m/8m/9m/10m/20m/30m/1h的间隔重新发送通知,直到成功为止,但不保证通知最终一定能成功。 - 如果长时间没有收到回调通知,可以使用对应业务接口进行主动查询,