---
title: "API認証｜Spark!ドキュメント | Chargezen"
description: "Spark! APIでの認証。Chargezen Spark!ドキュメント「APIリファレンス」より。"
url: "https://chargezen.com/ja/docs/spark/api/authentication"
lang: "ja"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/ja/docs/spark/api/authentication

# API認証

Spark! APIでの認証

最終更新日：2026-01-19

Spark! APIはAPIキーで認証します。すべてのリクエストのAuthorizationヘッダーにキーを含めます。

## APIキーの取得

1.  Settings → API → API Keysに移動します
2.  "Create API Key"をクリックします
3.  「本番」「ステージング」などの名前を付けます
4.  読み取り専用または読み書きの権限を設定します
5.  キーをコピーして安全に保管します

キーを秘密に保つ

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`

サンドボックスでのテスト

テストにはサンドボックスを使います。本番を再現しますが、実データへの影響や実際の支払いは発生しません。

## 次のステップ

[

### RESTエンドポイント

全エンドポイントのリファレンス

詳しく見る



](https://chargezen.com/ja/docs/spark/api/endpoints)[

### Webhook

イベント通知

詳しく見る



](https://chargezen.com/ja/docs/spark/api/webhooks)

### 関連記事

[

#### RESTエンドポイント

APIエンドポイントのリファレンス



](https://chargezen.com/ja/docs/spark/api/endpoints)[

#### Webhook

イベント通知



](https://chargezen.com/ja/docs/spark/api/webhooks)

このページは役に立ちましたか？

さらにサポートが必要ですか？ [サポートに問い合わせる](https://chargezen.com/ja/docs/checkoutos/troubleshooting/support)