使用建议 #
优先使用默认 HTML 返回
如果你只需要目标页面 HTML,只传 target_url 即可。未传 format 时,接口默认返回 HTML。
{
"target_url": "https://example.com"
}
HTML 返回更适合接入现有爬虫处理链路,也通常比截图类请求更快。
谨慎开启 js_render
js_render=1 会启用页面渲染,通常响应时间更长。建议先不传或传 0 测试,如果页面内容缺失,再开启渲染。
记录 request_id
每次请求都建议记录响应头 X-Request-Id。当需要排查请求失败、超时或结果异常时,可以通过该 ID 更快定位问题。
客户端重试
对于超时、服务暂时不可用、限流等错误,可以在客户端进行有限重试。
建议:
- 使用指数退避。
- 不要无限重试。
- 对参数错误、认证失败、余额不足这类错误不要自动重试。
- 对限流错误应降低并发或等待后重试。