如何為開發者取得 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 主網區塊。

常見問題解答

Q：我可以在多個網域中使用相同的 UniSat API 金鑰嗎？答：不可以。每個網域都必須在應用程式設定期間明確註冊。跨域使用會觸發 CORS 拒絕，並使請求在到達後端服務之前失效。

Q：UniSat 是否支援無需停機的 API 金鑰輪換？答：是的。在舊金鑰保持活動狀態時產生新金鑰，更新您的服務配置，然後在驗證確認穩定運行後撤銷先前的金鑰。

Q：測試網銘文是否可以透過生產 API 存取？ A：不可以，生產API專門服務主網資料。 https://testnet-api.unisat.io存在一個單獨的測試網路端點，需要自己的應用程式註冊和金鑰。

Q：如果我的申請超過每日配額門檻，會發生什麼事？答：請求失敗並顯示 HTTP 403 Forbidden，並包含顯示為零的X-RateLimit-Remaining標頭。無論使用模式如何，配額都會在 UTC 午夜重置。