API Authentication

API 経由で OpenBait にアクセスする方法


OpenBait API は API Key による認証を使用します。すべてのリクエストに Authorization header が必要です。

API Key の取得

  1. コンソールにログイン
  2. 設定 > API Keys に移動
  3. Create Key をクリック
  4. API Key をコピーして安全に保管

API Key は作成時に一度だけ表示されます。紛失した場合は再作成が必要です。

Authentication

すべての API リクエストの header に以下を追加:

Authorization: Bearer your_api_key

Base URL

https://api.openbait.com/v1

Request Example

curl -X GET "https://api.openbait.com/v1/threats" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

Response Format

すべての response は JSON 形式です:

{
  "data": [...],
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 20
  }
}

Error Response

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}
Status Code説明
400Bad Request — パラメータエラー
401Unauthorized — 認証失敗
403Forbidden — アクセス権限なし
404Not Found — リソースが存在しない
429Too Many Requests — レート制限超過
500Internal Server Error

Rate Limits

PlanLimit
Free60 req/min
Pro600 req/min
EnterpriseUnlimited

制限超過時は 429 が返されます。Response header:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705749600

    API Authentication | OpenBait