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 會暴露你的密鑰，因此只用於你自己的工具。