認証 API

すべてのAPIリクエストには認証が必要です。

APIキー認証

ヘッダー形式

Authorization: Bearer qt_your_api_key

リクエスト例

curl https://api.quicktrust.jp/v1/verification-sessions \
  -H "Authorization: Bearer qt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

認証エラー

401 Unauthorized

APIキーが無効または未指定：

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

403 Forbidden

APIキーは有効だが権限不足：

{
  "error": "Forbidden",
  "message": "Access denied"
}

セッション認証

エンドユーザー向けのエンドポイント（検証フロー中）は、Cookie ベースのセッション認証が使用されます。これはサーバー間通信ではなく、検証ページからの内部リクエストに使用されます。

INFO

セッション Cookie は verificationUrl にアクセスした際に自動的に設定されます。開発者がこれを直接扱う必要はありません。