API認証
Spark! APIでの認証
最終更新日：2026-01-19
Spark! APIはAPIキーで認証します。すべてのリクエストのAuthorizationヘッダーにキーを含めます。
APIキーの取得
- Settings → API → API Keysに移動します
- "Create API Key"をクリックします
- 「本番」「ステージング」などの名前を付けます
- 読み取り専用または読み書きの権限を設定します
- キーをコピーして安全に保管します
キーを秘密に保つ
APIキーはSpark!データへの完全なアクセスを提供します。クライアント側コード、公開リポジトリ、ログには絶対に公開しないでください。
APIキーの使用
Authorizationヘッダーにキーを含めます。
Authorization: Bearer YOUR_API_KEY
レート制限
APIリクエストには制限があります。
- 標準 — 毎分100リクエスト
- 一括操作 — 毎分10リクエスト
- Webhook — 送信は無制限
各レスポンスにレート制限のヘッダーが含まれます。
X-RateLimit-Limit— 許可される最大リクエスト数X-RateLimit-Remaining— 残りのリクエスト数X-RateLimit-Reset— 制限がリセットされるUnixタイムスタンプ
エラー処理
APIエラーは標準HTTPステータスコードを返します。
- 400 — 不正なリクエスト（無効なパラメーター）
- 401 — 未認証（APIキーが無効または未指定）
- 403 — 禁止（権限不足）
- 404 — 見つからない
- 429 — リクエスト過多（レート制限）
- 500 — サーバーエラー
環境
- 本番 —
https://api.chargezen.com/spark/v1 - サンドボックス —
https://sandbox.chargezen.com/spark/v1
サンドボックスでのテスト
テストにはサンドボックスを使います。本番を再現しますが、実データへの影響や実際の支払いは発生しません。
次のステップ
このページは役に立ちましたか？
さらにサポートが必要ですか？ サポートに問い合わせる