亮点
验证页面只有两种合理的处理结果:要么成功获取其背后的目标页面,要么不为此付费。本周 Reddit、eBay 和接入 Imperva 的网站已支持该规则。自动充值现已支持自动触发,避免长时间运行的任务耗尽额度。此外,返回 "Invalid API key" 明确表示密钥本身错误。大部分内容已发布在 更新日志 中;以下是本周要点汇总。
新功能
Reddit、eBay 和 Imperva 验证页面
Reddit 对来自许多 IP 地址的请求会先返回一个简短的 JavaScript 检查页面,该页面标题仅为 "Reddit"。Proxy Finder 和 Auto 现在会在同一个出口节点上完成该项检查,并返回请求的目标页面。费用按标准页面价格收取,与其他常规页面一致。
eBay 有时会对商品详情页的冷请求返回拦截页面,该页面在浏览器中运行检查后跳转至目标商品。Browser 现在会等待检查完成并返回目标页面。如果 eBay 仍然拒绝访问,系统会返回检查页面,且不计费。
Imperva 的质询页面、incident 页面和拦截页面现已列入已知验证页面列表中。Single、Browser 和 Proxy Finder 会在 X-FourA-Check-Page header 中对其进行标记且不计费。Auto 将其视为未命中:当已保存的会话遇到此类页面时,它会继续寻找实际页面,而不是直接返回验证页面。
站点验证参考文档 列出了所有已支持识别的系统以及每个 endpoint 对其采取的处理逻辑。如果验证页面曾被误当做正常数据存入你的数据集(我们在 具体成因 中分析过此类情况),现在这类问题在这三个平台上已得到解决。
自动充值
如果你当前使用的套餐支持按量充值,Dashboard 中的 Billing 页面现已支持自动执行购买。你可以设置触发阈值,在额度消耗达到 80%、85%、90% 或 95% 时触发。同时可以配置每次充值的额度以及每个账单周期内的最大触发次数。每次充值都会通过已保存的银行卡扣款,生成单独的账单并通过邮件发送通知。
扣款失败后不会自动重试。充值规则会自动暂停,对话框中会显示失败日期与具体原因,例如银行卡被拒或银行要求进行二次支付确认。解决问题后重新保存规则即可恢复自动充值。
建议将每个周期的充值次数上限设低。该设置旨在防止异常任务通宵持续扣费,而非用于替代预算管理。自动充值指南 详细介绍了各项具体配置。
"Invalid API key" 仅代表密钥本身错误
返回带有 "Invalid API key" 的 401 响应现在严格表示系统已校验你的密钥并确认其无效。客户端收到此错误后应立即终止请求。如果系统暂时无法验证密钥有效性,过去 10 分钟内验证通过的密钥将继续保持可用。否则系统将返回 503 状态码,内容为 API key check temporarily unavailable 并附带 Retry-After: 5,且该请求不计费。
这一区分便于在代码中进行针对性处理:
import time
import requests
for attempt in range(3):
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
if r.status_code == 401:
raise SystemExit(r.json()["error"]) # the key is wrong: fix it, don't retry
if r.status_code == 503 and "Retry-After" in r.headers:
time.sleep(int(r.headers["Retry-After"]))
continue
break
错误参考涵盖了所有四种 503 错误以及各自对应的处理方式。
文档与博客支持 Markdown 格式
在任何文档页面或博客文章后追加 .md,或使用 Accept: text/markdown 发起请求,即可获取干净的 Markdown 格式,供 AI 助手直接读取而无需解析页面外围元素。首页、定价页、API、proxy port 以及 MCP 页面同样提供 Markdown 版本,且 llms.txt 关联了各页面的 Markdown 地址。每个文档页和文章还配有“复制为 Markdown”按钮,旁边附有“在 ChatGPT 中打开”与“在 Claude 中打开”。
(本篇摘要也不例外。在其 URL 末尾添加 .md 即可。)
其他细节修复
- 将注册页面停留在“检查您的电子邮件”步骤时,您只会收到所请求的那封验证邮件,标签页等待期间不会重复发送。在该步骤点击重新发送邮件可在需要时获取新副本。
- 控制台概览会自适应屏幕调整面板布局,在任何宽度下都能填满整行。流量与时间数据经舍入以适配单元格显示,悬停可查看精确值。Auto 的数值在 Requests 与 Credits 卡片中均以绿色标出,新账户的示例概览中也已包含 Auto。
- 已翻译的文档页面沿用与英文版相同的章节锚点,确保章节链接与目录能在全部 13 种语言中正确定位到对应标题。翻译文档和文章中的标题现已完成本地化。
- 博客顶部导航添加了指向 Comparisons 的链接,其中的每篇文章都将 FourA 与特定服务商进行了价格对比。顶部导航自适应各种屏幕尺寸,从小屏手机到宽屏显示器均可正常显示。
底层架构
新增的 proxy port 连接现已分发至我们所有的服务器,机制与现有的 API 调用一致。若某台服务器的 proxy port 或 API 停止响应,会自动退出轮询并在恢复健康后重新加入。您的客户端配置或 proxy username 无需进行任何修改。
我们每准确识别出一个验证页面,您的解析器就少面对一个存疑的 200 响应。