结果获取与轮询
当任务无法即时完成时,API 会返回一个 taskId(HTTP 201)。请使用该 taskId 轮询结果
接口,直到数据准备就绪(HTTP 200)。
HTTP 状态码
| 状态码 | 含义 | 操作 |
|---|---|---|
| 200 | 成功 | 直接使用响应体中的数据。 |
| 201 | 任务处理中 | 轮询 /result/{taskId}(推荐间隔:1-5 秒)。 |
| 400 | 参数无效 | 请检查任务参数是否有效。 |
| 429 | 超出速率限制 | 降低请求频率,或联系支持团队调整配额。 |
| 500 | 服务器内部错误 | 1 分钟后重试;若持续出现请联系支持团队。 |
轮询获取结果
使用你的 taskId 调用结果接口,直到其返回 HTTP 200。
curl --location --request GET 'https://api.scrapeless.com/api/v1/scraper/result/30681c8b-bfd3-48eb-a7c9-006e40b00591' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json'
注意事项
- 轮询建议
- 间隔:1-5 秒。
- 超时:设置最大重试次数上限(例如 10 次尝试)。
- 调试技巧
- 先使用简单的 URL 进行测试。