UNLOCK API
取得 API 金鑰
API 金鑰和安全
MarkdownOpenAPI

API 金鑰和安全

如何傳送金鑰、使用多個金鑰，以及只允許你的伺服器。

你的金鑰

每個請求都要帶上帳號頁面上的 API 金鑰：JSON 請求中為 clientKey，in.php 和 res.php 中為 key。金鑰為 32 個字元（0-9、a-f）。請放在你的伺服器上；任何拿到金鑰的人都能花用你的餘額。
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

更多金鑰

你可以在帳號頁面最多建立 5 個額外金鑰，例如每台伺服器或每個專案一個。它們共用餘額，會顯示最後使用時間，也可以逐一停用。

IP 允許清單

在帳號頁面最多加入 20 個 IP 位址，之後只有這些位址能使用你的金鑰。來自其他位址的請求會得到 ERROR_IP_NOT_ALLOWED，且不扣費。
錯誤
{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

從瀏覽器呼叫

傳送 header_acao=1 時，in.php 和 res.php 會加上 CORS 標頭 Access-Control-Allow-Origin: *。從公開網頁呼叫 API 會暴露你的金鑰，因此只用於你自己的工具。