ドキュメント·認証とAPIキー
🔑

認証とAPIキー

ベアラートークン、キーローテーション、IPアローリスト、そして認証失敗時に表示されるエラー。

ベアラートークン

https://api.eveses.com へのすべてのリクエストはAPIキーをベアラートークンとして運びます:

Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

キーは Account → API Keys で作成します。パスワードのように扱ってください——残高、アクティベーション、レンタルへの完全なアクセス権を付与します。

作成

New key をクリックし、ラベルを付けます(local-dev、ci、production-eu)。トークンは作成時に一度だけ表示されます——すぐに保存してください。

ローテーション

キーは編集できません。ローテーションするには:新しいキーを作成 → デプロイで入れ替え → 古いキーを削除。削除は即時。

IPアローリスト

キーごとのアローリスト:キーを特定のIP / CIDRレンジに紐付けます。リスト外からのリクエストは403を受けます。キー詳細ページで設定。

Scopes

すべてのキーが現在フルアカウントアクセスを付与します。スコープ別キー(read-only、rentals-only)はロードマップ上。

エラー

HTTP 意味
401 Authorization ヘッダーがないか不正
403 キー失効、アカウント停止、またはIPがアローリスト外
429 キーごとのレート制限超過(デフォルト60rpm)