集成失败时查看 solvethree 请求日志

1. 1.

   打开请求日志

   在控制台中打开 /request-logs。搜索框通过占位文字标识：“请求 ID、站点、操作或错误”。搜索你记录的任务/请求标识符；使用站点或操作查找相关尝试。

2. 2.

   先选择“全部”

   查找请求时，保持选中“全部”筛选条件。然后使用“成功”“失败”“排队中”或“已拒绝”缩小结果范围。一开始就使用较窄的筛选范围，可能会隐藏你正在调查的尝试。

3. 3.

   匹配时间戳

   各列分别为请求 ID、站点、操作、计费、延迟、时间和结果。将时间、站点和操作与你的应用记录进行匹配，以免调查同一目标上的另一次尝试。

比较相关行的延迟，找出较慢的尝试。同时保留应用的 HTTP 耗时记录；不要认为控制台中的某一个值就能解释客户端观察到的全部延迟。

“导出 CSV”会导出筛选后的行。导出前，请设置搜索和筛选条件以定位相关尝试，然后在分享前检查文件。

控制台筛选条件描述的是服务请求/求解结果。“成功”并不表示下游网站已接受你的令牌。请通过 HTTP 响应和任务载荷确定哪个环节失败。

API 返回了非成功 HTTP 状态。

读取客户端记录的状态和错误响应。不要将其当作成功的任务载荷。

试试这样做： 先处理 HTTP 错误，并在重试前纠正报告的问题。不要认为所有失败都意味着余额不足。请参阅 API 错误处理。

任务正在等待或求解中。

这些是非终态的任务状态，并非可用解答。

试试这样做： 继续轮询该任务，直到其就绪或失败。不要仅因解答尚未可用就创建替代任务。

任务已失败。

同时读取 errorCode 和 error。例如，site-unreachable 是一个任务错误码。

试试这样做： 停止轮询该任务，并在再次尝试前处理报告的原因。求解失败会退款；输入无效时，不加修改地重试并不能解决问题。

任务创建超时，无法确定是否成功。

保留所有任务 ID 以及此次尝试使用的 requestId。连接超时不能证明创建失败。

试试这样做： 如果有任务 ID，请检索该任务。否则，如果你提供了 requestId，请使用该 ID 重新提交相同的任务请求，以恢复已有任务。不要在更改输入后复用该 ID，否则会产生冲突。

任务已就绪，但网站拒绝提交。

检查发往网站的请求。确认其中包含的是 solution.token，而不是任务 ID 或旧令牌。

试试这样做： 将返回的 userAgent 和 secChUa 与成功的代理和预期目标配合使用。不要混用身份，也不要在求解与提交之间切换代理。目标返回 HTTP 403 本身并不能确定是哪种防护拒绝了请求。

如果原因仍不明确，请联系 [email protected]，并提供足够的信息，以便定位此次尝试，区分服务失败与网站提交被拒绝。

• 任务 ID 和/或 requestId、产品，以及带时区的时间戳。
• API HTTP 状态，或终态任务的 errorCode 和 error。
• 目标主机名和 action。
• 脱敏后的响应描述，注明响应来自 solvethree 还是目标网站。
• 如有帮助，可提供筛选后的相关日志行，发送前须检查并脱敏。

从报告及所有附件中移除 API 密钥、代理密码、令牌、Cookie 和客户数据。支持团队接受脱敏后的任务/请求 ID 和时间戳；定位此次尝试不需要原始令牌。