Эндпоинты ключей API
Эндпоинты для управления собственными ключами API. Все пути находятся на https://api.recordmeeting.com и требуют ключ API. См. Аутентификация.
Первый ключ нужно создать в приложении, в разделе Настройки ➤ Ключи API. См. Руководство пользователя ➤ Ключи API.
Создать ключ API
Заголовок раздела «Создать ключ 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.
Список ключей API
Заголовок раздела «Список ключей 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
Заголовок раздела «Отозвать ключ API»DELETE /v1/api-keys/:idБезвозвратно отзывает ключ API. Запросы, использующие этот ключ, с этого момента завершаются ошибкой 401 INVALID_API_KEY. Это действие нельзя отменить.
204 No Content с пустым телом.
Коды ошибок
Заголовок раздела «Коды ошибок»| Код | HTTP-статус | Значение |
|---|---|---|
API_KEY_NOT_FOUND | 404 | Ключ не существует или принадлежит другой учётной записи |
ALREADY_REVOKED | 400 | Ключ уже был отозван |