# Blockscout 旧 API 失效：核对 PRO key、链路由与额度

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/blockscout-pro-api-key-and-route-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用已有脱敏请求排查迁移问题，区分实例网页、REST、兼容 API 和 ETH RPC；免费套餐也有认证条件。

## 使用工具
- [Blockscout](https://lianxiaozhi.com/tools/blockscout) · [官方入口](https://www.blockscout.com/)

## 前置条件
- 准备原有只读请求的主机、路径、参数名、HTTP 状态、响应体和时间；移除所有 key 值。
- 教程核验截至 2026-10-12 的官方文档，不注册账户、购买套餐、调用认证 API 或执行链上操作。

## 1. 先分开网页可用与 API 可用

现行 API 总览说明 per-instance API support 已弃用，旧 MyAccount key 与原路由不能直接用于 PRO API。保存原请求和产品类型，再查实例版本及支持链；网站能查交易不证明旧 API 仍可用。v12 公告写明逐步部署，不能只凭日期断言所有实例已升级，也不能由一次 403 断定它由迁移引起。

核对结果：网页、旧实例 API、PRO API 与具体版本证据分开。
依据：[Blockscout：现行 API 与实例弃用说明](https://docs.blockscout.com/devs/apis)
依据：[Blockscout：v12 分页和 RPC 变更](https://docs.blockscout.com/blockscout-v12-0-0-api-updates-and-breaking-changes)

## 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 名称不同；不要把路径前缀、链参数和返回格式相互拼接。

核对结果：链、接口家族、主机、路径和参数名有一一对应的脱敏记录。
依据：[Blockscout：认证、路由、响应头与 credits](https://docs.blockscout.com/devs/pro-api-responses-and-routes)
依据：[Blockscout：PRO API 与套餐单位](https://docs.blockscout.com/devs/pro-api)

## 3. 检查正确 key 类型和授权位置

PRO 的所有套餐包括免费档均需 PRO key。官方接受 apikey 参数或 authorization 头，ETH RPC 示例用 Bearer 格式；检查自己的原配置是否符合该接口示例，不把旧实例 key 当新 key。若没有现成授权，仅标记待补，不复制示例占位符当有效凭据；共享记录只保留参数名与授权类型。

核对结果：PRO key 类型与传递位置明确，秘密未进入页面、截图或排错清单。
依据：[Blockscout：认证、路由、响应头与 credits](https://docs.blockscout.com/devs/pro-api-responses-and-routes)
依据：[Blockscout：现行 API 与实例弃用说明](https://docs.blockscout.com/devs/apis)

## 4. 按 credits 与速率分别看费用

当前套餐页写免费档 100K credits/day 与 5 RPS，credits 不是请求次数。路由说明的未单列端点默认 20 credits，具体较重端点另计且可调整；每翻一页又是一次调用。已有响应可检查 x-credits-remaining 与速率头，reset 为距离重置的毫秒，-1 可代表内部错误。免费额度用尽后请求失败，付费超额按合同可能继续计费，不推定自动免费降速。

核对结果：套餐日期、端点单价、页数、额度和 RPS 分开，不承诺永久免费或固定账单。
依据：[Blockscout：PRO API 与套餐单位](https://docs.blockscout.com/devs/pro-api)
依据：[Blockscout：认证、路由、响应头与 credits](https://docs.blockscout.com/devs/pro-api-responses-and-routes)

## 5. 保留错误来源，限制结论

先记录 HTTP 状态，再读原 body。PRO 错误可含 error 与 source：internal 的 404 先核路由/支持链，upstream 的 5xx 或超时先保留上游异常；正常代理返回也可能原样来自实例，不能强套所有 PRO 错误表。认证、额度、服务失败不填余额零或交易失败。输出旧/新路由对照与待补项；没有真实成功响应就停在配置和文档核对。

核对结果：错误来源与读取结论分开，没有把配置核验写成 API 成功或资金到账。
依据：[Blockscout：代理错误与上游响应](https://docs.blockscout.com/devs/error-responses)
依据：[Blockscout：认证、路由、响应头与 credits](https://docs.blockscout.com/devs/pro-api-responses-and-routes)

## 常见错误
- 免费 PRO API 需要 key，公开网页可读不是 API 免认证证明。
- credits、请求次数与 RPS 是不同单位。
- HTTP 403 本身不能确定是迁移、权限还是网络层原因。

## 完成检查
- 形成接口家族、链、脱敏路由、认证类型、额度与原错误的核对表，标明未获成功响应的部分。
- 本教程为官方文档整理，未验证任何现有账户、key、套餐或实际查询。

## 相关知识
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)

## 官方依据
- [Blockscout：现行 API 与实例弃用说明](https://docs.blockscout.com/devs/apis)
- [Blockscout：PRO API 与套餐单位](https://docs.blockscout.com/devs/pro-api)
- [Blockscout：认证、路由、响应头与 credits](https://docs.blockscout.com/devs/pro-api-responses-and-routes)
- [Blockscout：代理错误与上游响应](https://docs.blockscout.com/devs/error-responses)
- [Blockscout：v12 分页和 RPC 变更](https://docs.blockscout.com/blockscout-v12-0-0-api-updates-and-breaking-changes)