API リファレンス
各 X114 API エンドポイントの参照:認証、リクエストスキーマ、レスポンススキーマ、実際に動く curl 例。
ベース URL
すべてのエンドポイントは同じベース URL 配下にあります。本番環境では HTTPS を使用してください。
https://x114.org/api/v1認証
すべてのリクエストには Bearer トークンが必要です。サインアップ後、設定 → API キーで作成してください。
Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxクレジット
呼び出しごとに 1 クレジットを消費します。残高不足は 402 を返します。永久プランのクレジットは失効しません。
ステータスコード
すべてのエンドポイントで同じ形式が使用されます。
| コード | 意味 |
|---|---|
| 401 | API キーが見つからないか無効です。 |
| 402 | クレジット不足 — ダッシュボードからチャージしてください。 |
| 429 | レート制限を超えました — バックオフして再試行してください。 |
| 500 | サーバーエラー — バックオフを付けて安全に再試行できます。 |