回调通知
# 回调通知
回调通知是将结果以异步消息通知的方式向您发送,服务端将结果以POST请求的方式,发送到您设置的HTTP回调通知地址。
### 回调地址
通常是您自己的业务服务器的公网地址。回调地址需要满足以下要求:
- 应为HTTP/HTTPS协议接口的公网可访问URL
- 支持POST方法
- 支持传输数据编码采用UTF-8
- 支持数据接收格式为application/json
### 回调消息Header
| Header | 类型 | 必填 | 描述 |
| :- | :-| :- | :-|
| timestamp | string | 是 | UTC时间戳,如:2020-10-01T13:00:00Z |
| signature | string | 是 | 签名结果串 |
通过HmacSHA1摘要算法签名来验证消息是否可靠,将Header中的`timestamp`值作为待签名串,平台分配的`accessKeySecret`值作为密钥,将签名结果与Header中的`signature`值进行对比,如果一致表示消息可靠。
### 回调内容
回调通知的内容将以json形式存放在请求Body中,不同的回调通知地址返回的数据内容详见各文档。
### 回调次数
您的服务端接收到回调消息后,若返回的HTTP状态码为200,表示接收成功,接收成功之后将不会再进行推送。
若返回其他的HTTP状态码,均视为接收失败,将会重复推送回调消息,直至您接收成功。
最多重复推送回调消息15次,回调通知的间隔为2的x次幂,x为当前第几次推送,单位为秒。
2 ^ 1 = 2
2 ^ 2 = 4
...
2 ^ 14 = 16384
2 ^ 15 = 32768