如何为开发者获取 UniSat API 密钥？ （开发者工具）

访问 UniSat 开发者门户

1. 导航至 UniSat 官方网站，然后在主导航菜单中找到“开发人员”或“API”部分。

2. 单击标有“开发人员工具”或“API 文档”的链接，该链接会重定向到专用子域或路径，例如https://dev.unisat.io 。

3. 确保您的浏览器不会阻止第三方 cookie，因为门户依赖基于会话的身份验证来创建帐户和生成密钥。

4. 如果您尚未安装 UniSat 钱包扩展程序，请先从 Chrome Web Store 或 Firefox Add-ons 下载并设置它，然后再继续。

5. 使用您的 UniSat 钱包登录 — 系统通过加密签名质询而不是电子邮件/密码凭证来验证所有权。

注册应用程序

1. 通过身份验证后，转到开发人员仪表板内的“应用程序”选项卡。

2. 单击“+ 新申请”按钮开始注册。

3. 输入项目的描述性名称，例如“Bitcoin NFT Explorer”或“Ordinal Indexer Bot”。

4. 提供有效的回调 URL — 这必须是 HTTPS 端点，UniSat 可以在其中发送有关铭文确认等事件的 Webhook 通知。

5. 选择您的应用程序所需的权限：对区块链数据的只读访问、铭文元数据检索或完整的钱包交互功能。

生成和管理 API 密钥

1. 提交申请表后，UniSat 会生成一个唯一的客户端 ID，并将其与秘密 API 密钥一起显示在一次性模式窗口中。

2. 立即复制这两个值 — 密钥在第一次查看后被屏蔽，并且无法从界面再次检索。

3. 将密钥存储在安全的环境变量或保管库中；将其暴露在前端代码或公共存储库中会损害应用程序的安全性。

4. 向/v1/inscriptions或/v1/transactions等端点发出 HTTP 请求时，使用客户端 ID 作为X-Client-ID标头，使用密钥作为X-API-Key标头。

5. 通过应用程序设置下的“撤销密钥”选项撤销受损密钥 — 撤销将在 60 秒内在所有 UniSat 基础设施节点上生效。

速率限制和使用限制

1. 免费套餐应用程序每小时的请求数不得超过 1,000 个，每分钟的突发请求数不得超过 100 个。

2. 每个 API 密钥都绑定到特定的应用程序 ID — 尝试在多个注册的应用程序中使用一个密钥会触发自动限制。

3.返回HTTP状态429的请求表明已经超出了您当前的速率限制；响应包含一个Retry-After标头，指定距离下一次允许调用的秒数。

4. 批量操作（例如获取超过 500 个条目的铭文列表）需要分页参数（ limit和offset ）——忽略它们会导致响应被截断。

5. API 返回的所有时间戳均遵循 ISO 8601 格式和 UTC 时区，区块高度值仅反映已确认的 Bitcoin 主网区块。

常见问题解答

问：我可以在多个域中使用相同的 UniSat API 密钥吗？答：不可以。每个域都必须在应用程序设置期间明确注册。跨域使用会触发 CORS 拒绝，并使请求在到达后端服务之前失效。

问：UniSat 是否支持无需停机的 API 密钥轮换？答：是的。在旧密钥保持活动状态时生成新密钥，更新您的服务配置，然后在验证确认稳定运行后撤销之前的密钥。

问：测试网铭文是否可以通过生产 API 访问？ A：不可以，生产API专门服务于主网数据。 https://testnet-api.unisat.io存在一个单独的测试网端点，需要自己的应用程序注册和密钥。

问：如果我的申请超过每日配额阈值，会发生什么情况？答：请求失败并显示 HTTP 403 Forbidden，并包含显示为零的X-RateLimit-Remaining标头。无论使用模式如何，配额都会在 UTC 午夜重置。