UNLOCK API
APIキーを取得
APIキーとセキュリティ
MarkdownOpenAPI

APIキーとセキュリティ

キーの送り方、複数キーの使い方、自分のサーバーだけを許可する方法。

APIキー

すべてのリクエストに、アカウントページのAPIキーを含めます。JSONリクエストではclientKey、in.phpとres.phpではkeyです。キーは32文字(0-9、a-f)です。キーはサーバー上に保管してください。キーを持つ人は誰でも残高を使えます。
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

追加キー

アカウントページで追加キーを最大5個作成できます。たとえばサーバーやプロジェクトごとに1つです。残高は共通で、最終使用日時が表示され、1つずつ無効にできます。

IP許可リスト

アカウントページでIPアドレスを最大20個登録すると、そのアドレスからのみキーを使えます。ほかのアドレスからのリクエストは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: *を付けます。公開WebページからAPIを呼び出すとキーが漏れるため、自分専用のツールでのみ使ってください。