# 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的间隔重新发送通知,直到成功为止,但不保证通知最终一定能成功。
  • 如果长时间没有收到回调通知,可以使用对应业务接口进行主动查询,
Last Updated: 3/23/2026, 2:46:36 PM