コンテンツにスキップ

API キーのエンドポイント

自分の API キーを管理するためのエンドポイントです。すべてのパスは https://api.recordmeeting.com 上にあり、API キーが必要です。認証 を参照してください。

最初のキーはアプリの Settings ➤ API keys で作成する必要があります。ユーザーガイド ➤ API キー を参照してください。

POST /v1/api-keys

アカウントの新しい API キーを作成します。

{
"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。


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 です。


DELETE /v1/api-keys/:id

API キーを完全に無効化します。以降、そのキーを使用したリクエストは 401 INVALID_API_KEY で失敗します。この操作は元に戻せません。

本文が空の 204 No Content。

コードHTTP ステータス意味
API_KEY_NOT_FOUND404キーが存在しないか、別のアカウントに属しています
ALREADY_REVOKED400キーはすでに無効化されています