API キーのエンドポイント
自分の API キーを管理するためのエンドポイントです。すべてのパスは https://api.recordmeeting.com 上にあり、API キーが必要です。認証 を参照してください。
最初のキーはアプリの Settings ➤ API keys で作成する必要があります。ユーザーガイド ➤ API キー を参照してください。
API キーの作成
Section titled “API キーの作成”POST /v1/api-keysアカウントの新しい API キーを作成します。
リクエストボディ
Section titled “リクエストボディ”{ "name": "My integration"}| フィールド | 必須 | 説明 |
|---|---|---|
name | はい | キーの表示名(1 から 100 文字) |
201 Created
{ "data": { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "key": "sk_rm_a1b2c3d4e5f6...", "created_at": "2026-09-19T15:00:00.000Z" }}エラー: 400 VALIDATION_ERROR。
API キーの一覧取得
Section titled “API キーの一覧取得”GET /v1/api-keysアカウントの API キーを返します。作成後に完全なキーの値が返されることはありません。
{ "data": [ { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "created_at": "2026-09-19T15:00:00.000Z", "last_used_at": "2026-09-20T10:30:00.000Z", "is_revoked": false } ]}一度も使用されていないキーの last_used_at は null です。
API キーの無効化
Section titled “API キーの無効化”DELETE /v1/api-keys/:idAPI キーを完全に無効化します。以降、そのキーを使用したリクエストは 401 INVALID_API_KEY で失敗します。この操作は元に戻せません。
本文が空の 204 No Content。
エラーコード
Section titled “エラーコード”| コード | HTTP ステータス | 意味 |
|---|---|---|
API_KEY_NOT_FOUND | 404 | キーが存在しないか、別のアカウントに属しています |
ALREADY_REVOKED | 400 | キーはすでに無効化されています |