错误与限制
| 事件 | 是否计费 |
|---|---|
| 成功请求（HTTP 200） | 1 个积分 |
启用渲染并成功（render_js=1） | 1 个积分 |
| 请求失败（超时、连接错误） | 0 个积分 |
| 目标返回 HTTP 4xx 或 5xx | 0 个积分 |
| 单次调用内的重试 | 计为一次父调用 |
只有当响应以 2xx 状态码和非空正文到达时才会计费。
| 套餐 | 最大并发请求数 |
|---|---|
| Starter | 20 |
| Growth | 50 |
| Business | 100 |
| Enterprise | 500 |
超出上限的请求将返回 429 Too Many Requests。请使用指数退避策略进行重试。
| 状态码 | 含义 | 处理方式 |
|---|---|---|
200 | 成功，响应正文已附带 | 正常处理 |
400 | 错误请求（参数格式错误） | 修正 extract_rules 或 url 参数 |
401 | api_key 无效或缺失 | 检查面板中的密钥 |
403 | 当前套餐不支持此功能 | 升级套餐或移除该标志（例如 Starter 套餐下的 premium_proxy） |
408 | 目标站点超时 | 使用更高的 timeout= 值重试，或简化选项 |
422 | 渲染失败（JS 崩溃、导航错误） | 重试；检查该站点在真实浏览器中是否正常工作 |
429 | 超出并发上限 | 退避后重试 |
500 | Shifter 内部错误 | 短暂延迟后重试，若问题持续请联系支持团队 |
509 | 套餐积分已用尽 | 升级套餐或等待下一个计费周期 |
对目标的失败抓取、CAPTCHA 以及临时性 5xx 错误，系统会在返回错误之前使用不同的代理自动重试（最多 3 次）。重试不会产生费用。
Webhook 传递
Section titled “Webhook 传递”对于长时间运行的抓取任务，可传入 webhook=<URL>，以便在响应准备就绪时将其通过 POST 方式发送到您的端点：
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"每次成功传递仍需支付 1 个积分。
实时的积分使用情况和错误率可在面板的 Web Scraping API → Usage 中查看。