一次读几个 URL,其中一个失败,会全部失败吗?
不会。单条 URL 读取失败不会拖垮整批 POST /v1/web/read 请求。每次可提交 1–10 个公开 HTTP(S) 链接,接口会将成功页面归入 results,将无法读取的页面归入 failed。
按 URL 对照 results 与 failed
即便整批链接全部无法读取,POST /v1/web/read 仍返回 HTTP 200,其中 results 为空数组,failed 逐条列出失败原因:
blocked:目标网站返回了访问拦截页或防爬挑战页。unreachable:目标页面无法拉取。
提交后按输入链接逐一核对 results 与 failed,并留存 request_id 便于追溯批次。例如迁移指南已成功进入 results,而发布日期公告出现在 failed(blocked)时,先输出有原文依据的迁移步骤,把发布日期标为待核,再为其他公开公告地址单独发起新的 Read 请求。
部分失败批次的计费规则
POST /v1/web/read 按 results 中成功读取的 URL 计费(每条 $0.002)。failed 中的 URL 不扣费,整批未读到任何页面时费用为零。
合同与相关问题
执行前免费检查对应合同:data:web.search, data:web.read, data:web.map。

