Перейти к содержимому

Эндпоинты ключей API

Эндпоинты для управления собственными ключами API. Все пути находятся на https://api.recordmeeting.com и требуют ключ 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.


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Ключ уже был отозван