Blockscout 旧 API 失效：核对 PRO key、链路由与额度
链小知 · 进阶 · 核验 · 依官方文档整理
用已有脱敏请求排查迁移问题，区分实例网页、REST、兼容 API 和 ETH RPC；免费套餐也有认证条件。
开始前准备
- 准备原有只读请求的主机、路径、参数名、HTTP 状态、响应体和时间；移除所有 key 值。
- 教程核验截至 2026-10-12 的官方文档，不注册账户、购买套餐、调用认证 API 或执行链上操作。
1. 先分开网页可用与 API 可用
现行 API 总览说明 per-instance API support 已弃用，旧 MyAccount key 与原路由不能直接用于 PRO API。保存原请求和产品类型，再查实例版本及支持链；网站能查交易不证明旧 API 仍可用。v12 公告写明逐步部署，不能只凭日期断言所有实例已升级，也不能由一次 403 断定它由迁移引起。
检查结果：网页、旧实例 API、PRO API 与具体版本证据分开。
2. 按接口家族核对主机与链标识
官方路线示例中，兼容 v2 API 使用 api.blockscout.com/v2/api?chain_id=10；REST 为 /10/api/v2/blocks/{block_number_or_hash}；ETH RPC 为 /10/json-rpc，使用 JSON-RPC 请求体。10 是 Optimism 示例，不代表任意对象都在这条链。Blockscout 的 chain_id 与 Etherscan 的 chainid 名称不同；不要把路径前缀、链参数和返回格式相互拼接。
检查结果：链、接口家族、主机、路径和参数名有一一对应的脱敏记录。
3. 检查正确 key 类型和授权位置
PRO 的所有套餐包括免费档均需 PRO key。官方接受 apikey 参数或 authorization 头，ETH RPC 示例用 Bearer 格式；检查自己的原配置是否符合该接口示例，不把旧实例 key 当新 key。若没有现成授权，仅标记待补，不复制示例占位符当有效凭据；共享记录只保留参数名与授权类型。
检查结果：PRO key 类型与传递位置明确，秘密未进入页面、截图或排错清单。
4. 按 credits 与速率分别看费用
当前套餐页写免费档 100K credits/day 与 5 RPS，credits 不是请求次数。路由说明的未单列端点默认 20 credits，具体较重端点另计且可调整；每翻一页又是一次调用。已有响应可检查 x-credits-remaining 与速率头，reset 为距离重置的毫秒，-1 可代表内部错误。免费额度用尽后请求失败，付费超额按合同可能继续计费，不推定自动免费降速。
检查结果：套餐日期、端点单价、页数、额度和 RPS 分开，不承诺永久免费或固定账单。
5. 保留错误来源，限制结论
先记录 HTTP 状态，再读原 body。PRO 错误可含 error 与 source：internal 的 404 先核路由/支持链，upstream 的 5xx 或超时先保留上游异常；正常代理返回也可能原样来自实例，不能强套所有 PRO 错误表。认证、额度、服务失败不填余额零或交易失败。输出旧/新路由对照与待补项；没有真实成功响应就停在配置和文档核对。
检查结果：错误来源与读取结论分开，没有把配置核验写成 API 成功或资金到账。
怎样确认完成
- 形成接口家族、链、脱敏路由、认证类型、额度与原错误的核对表，标明未获成功响应的部分。
- 本教程为官方文档整理，未验证任何现有账户、key、套餐或实际查询。
常见错误与边界
- 免费 PRO API 需要 key，公开网页可读不是 API 免认证证明。
- credits、请求次数与 RPS 是不同单位。
- HTTP 403 本身不能确定是迁移、权限还是网络层原因。