回调故障故障排除

请查看有关 Offerwall 回调失败故障排除指南以获取 Offerwall 奖励。

阅读时间7 分钟

最后更新于 2 天前

如果您遇到回调失败升高的情况，或者用户没有收到优惠墙奖励，则问题通常与终端配置、网络可达性、有效负载处理或 HTTP 方法不匹配有关。请查看以下故障排除指南以确定和解决故障的根本原因。

验证回调网址和方法配置

回调失败的最常见原因是无效网址或请求发送方式与服务器预期不匹配。检查控制面板设置以确保以下几点：

激活网址：确保配置了有效的回调网址，并且未被意外删除或设置为
```
NO_CALLBACK
```
。
**HTTP 方法（GET 与 POST）**验证回调配置为 GET（默认）还是 POST 请求的形式发送。
- 如果配置为 GET 或 POST，请确保终端已显式配置为监听并正确解析所选方法。
- 如果配置为 POST，请确保服务器正在正确读取请求正文。
格式：验证网址是否具有有效的方案（
```
https://
```
）、主机和路径，并且没有输入错误或格式错误的查询字符串。
环境：确认网址指向生产环境，而不是临时或测试终端。
参数：确保所有必需的参数和宏都存在于网址结构中。

如果 Offerwall 服务器无法访问您的终端，回调可能会失败。检查服务器和网络生命值/血量/体力值是否有以下内容：

Offerwall 需要 200 个 OK 响应。如果服务器返回其他 HTTP 状态代码，则会记录失败并可能重试。检查服务器日志以了解以下常见报错代码：

3xx（重定向）：避免重定向。迁移应直接在 Offerwall（提供墙）后台中更新。如果意外重定向，回调发送方可能会丢弃有效负载。
**400（错误请求）：**指示错误的请求。检查服务器是否由于缺少参数、格式不匹配或无效数据类型而拒绝有效负载。
**401 / 403（未授权/禁止）：**指示 Authentication 失败。验证身份验证令牌、签名或 IP 允许列表是否为最新。如果您最近旋转了密钥，请确保更新了 Offerwall。
404（未找到）：终端路径不正确或已被删除。检查是否在不更新回调网址的情况下执行了最近的服务器迁移。
**405（方法不允许）：**服务器正在拒绝 HTTP 方法。如果回调以 POST 形式发送，但服务器期望 GET（反之亦然），则几乎总是会发生这种情况。
409（冲突）：通常由重复的交易拒绝逻辑引起。确保幂等性逻辑不会太激进（例如，拒绝有效重试）。
**429（请求太多）：**服务器正在限制 Offerwall。调整速率限制以适应流量爆发。
5xx（服务器错误）：指示服务器上的后端不稳定、服务停机或应用程序崩溃。

如果回调正在到达服务器，但用户仍未获得奖励，则服务器可能会拒绝回调的内容：

签名匹配：如果需要签名 Authentication，请验证哈希逻辑是否与 Offerwall 预期格式匹配。
宏分辨率：检查用户 ID、交易 ID 和奖励金额是否正在正确解析，而不是作为文本字符串处理（例如，读取
```
[USER_ID]
```
而不是实际用户 ID）。
下游处理：如果要返回 200 个 OK，但用户仍未获得奖励，请调查下游处理情况。确保回调确认与您的实际用户奖励事件保持一致。

如果回调失败突然激增，请对照您自己的内部工程日志来交叉参考失败的确切时间。请考虑以下问题：

如果您已验证上述所有故障排除指南，但仍遇到回调故障，请联系您的帐户经理或支持代表并提供以下信息：