Platform For AI:LLM インテリジェントルーティングワークベンチ

7.1 新規ユーザーのプロビジョニング

リクエスト：POST /api/provision

例：

curl -X POST "https://gateway.example.com/api/provision" \
  -H "Authorization: Bearer <admin_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "田中 太郎",
    "email": "taro.tanaka@company.com",
    "employee_id": "12345",
    "department": "技術部"
  }'

7.2 プロビジョニングによるキーのリセット

このメソッドは、ユーザーがすでに存在しているものの、新しい API キーが必要な場合に使用します。

リクエスト：POST /api/provision/reset

例：

curl -X POST "https://gateway.example.com/api/provision/reset" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"employee_id":"12345"}'

7.3 プロビジョニングリンクの検証

ユーザーが provision_url を開くと、Web ページがこのエンドポイントを呼び出してトークンを検証し、ユーザー情報と API キーを取得します。

リクエスト：GET /api/provision/verify?token={token}

新規ユーザー登録 (プロビジョニング)

プロビジョニング方式では、ワンタイムリンクを通じて API キーを配信するため、より安全です。

# 1. ユーザーを作成し、プロビジョニングリンクを取得します。
curl -X POST "https://gateway.example.com/api/provision" \
-H "Authorization: Bearer <admin_api_key>" \
 -H "Content-Type: application/json" \
 -d '{"name":"田中 太郎","email":"taro.tanaka@company.com","employee_id":"12345","department":"技術部"}'
# 2. 返された provision_url をユーザーに送信します (例：メールやインスタントメッセージ経由)。

# 3. ユーザーがリンクを開くと、ページが自動的に /api/provision/verify を呼び出して API キーを取得します。

新規ユーザー登録 (直接作成)

# 1. ユーザーがすでに存在するかどうかを確認します。
curl -X GET "https://gateway.example.com/api/users/check?employee_id=12345" \
-H "Authorization: Bearer <admin_api_key>"

# 2. ユーザーが存在しない場合は、ユーザーを作成します。
curl -X POST "https://gateway.example.com/api/users" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"name":"田中 太郎","employee_id":"12345","department":"技術部"}'

# 3. 返された api_key をユーザーに送信します。

ユーザーオフボーディング (無効化または削除)

# ユーザーを無効化します (推奨)。
curl -X PUT "https://gateway.example.com/api/users/user_xxx" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"enabled": false}'

# または、ユーザーを削除します。
curl -X DELETE "https://gateway.example.com/api/users/user_xxx" \
-H "Authorization: Bearer <admin_api_key>"

APIキーの回復 (プロビジョニング)

# 従業員 ID でキーをリセットし、新しいプロビジョニングリンクを送信します。
curl -X POST "https://gateway.example.com/api/provision/reset" \
-H "Authorization: Bearer <admin_api_key>" \
-H "Content-Type: application/json" \
-d '{"employee_id":"12345"}'

# 返された provision_url をユーザーに送信します。

APIキーの回復 (直接リセット)

# 従業員 ID でユーザー情報を取得します。
curl -X GET "https://gateway.example.com/api/users/check?employee_id=12345" \
-H "Authorization: Bearer <admin_api_key>"

# 返された user_id を使用して API キーをリセットします。
curl -X POST "https://gateway.example.com/api/users/user_xxx/regenerate-key" \
-H "Authorization: Bearer <admin_api_key>"