BlockReq
在 GitHub 编辑

API Key 与应用管理

API Key 用于鉴权你对 BlockReq RPC 端点的请求。每创建一个端点，系统都会生成对应的独立 API Key。

获取 API Key

从 Dashboard 获取

  1. 登录 BlockReq Dashboard
  2. 在左侧进入 Settings
  3. 在 API Keys 区域查看你的 key
  4. 点击复制图标即可复制

从端点页面获取

每个端点会显示 API Key、HTTPS URL、WSS URL。进入 Endpoints 可查看全部端点。

创建应用（端点）

端点是访问指定区块链网络的入口。创建步骤如下：

  1. 进入 Endpoints
  2. 点击 + Add Endpoint
  3. 选择区块链网络
  4. （可选）设置便于识别的名称
  5. 创建完成后复制 RPC URL 开始开发

详细步骤和代码示例见 创建第一个端点。

使用 API Key

将端点 URL 中的 BRQ1P0000000000000000000000000000000000000000000000000000000 替换为你的真实 key：

HTTPS: https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000
WSS:   wss://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000

快速示例

curl -X POST https://ethereum-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

程序化管理

管理 REST 在 Web 上。使用 Management API Key：Authorization: Bearer akv1_...，与 Dashboard 登录会话是同一所有者。见 BlockReq API。

操作路径
列出网络GET /api/dashboard/chains
创建端点POST /api/dashboard/endpoints
列出端点GET /api/dashboard/endpoints
删除端点DELETE /api/dashboard/endpoints
用量GET /api/dashboard/endpoints/stats

安全最佳实践

  • 不要在前端暴露 API Key：建议通过后端代理调用
  • 通过创建新端点并切换配置来完成 Key 轮换
  • 开发、预发、生产环境使用 不同端点
  • 在 Dashboard 监控用量，及时发现异常