Перейти к основному содержанию
POST
Новые ключи
Универсальный эндпоинт для перегенерации токенов API и/или WebSocket. Прежний токен аннулируется, а все связанные настройки, подписки и ограничения прав переносятся на вновь сгенерированный токен.

Авторизация

Заголовок erlcrussia-api-key не является строго обязательным, если вы перегенерируете WebSocket-ключ. Вы можете передать:
  • erlcrussia-api-key — для перегенерации HTTP API ключа (?api=true).
  • erlcrussia-websocket-key — для перегенерации WebSocket ключа (?websocket=true).
  • Либо оба заголовка при одновременной перегенерации (?api=true&websocket=true).

Query-параметры

Хотя бы один из параметров (?api=true или ?websocket=true) является обязательным. При передаче ?api=true&websocket=true будут перегенерированы оба ключа одновременно.
Ротация одного ключа разрешена раз в пять минут; при 429 учитывайте Retry-After. Успешная ротация записывается в аудит с ID ключа и IP, без секрета.

Авторизации

erlcrussia-api-key
string
header
обязательно

Пользовательский API-ключ. Храните на сервере; не включайте в клиентский JavaScript.

Параметры запроса

api
boolean

Перегенерировать HTTP API ключ

websocket
boolean

Перегенерировать WebSocket ключ

Ответ

Токен(ы) успешно перегенерирован(ы).

success
boolean
message
string
oldToken
string
newToken
string
token
string
apiKey
string
key
string
userId
string
serverId
string