Ротация API-токена

POST/v1/me/reset-tokenБесплатно

Выпускает новый API-токен. При успешной обработке запроса текущий токен сразу инвалидируется, и работать будет только новый.

То же самое доступно из бота.

Опасно

Новый токен приходит только в теле ответа — сохраните его и раскатайте по всем клиентам как можно быстрее. После успешной обработки старый токен возвращает 401. Если соединение оборвалось после отправки запроса и новый токен не был получен, выпустите ещё один токен через бота.

Авторизация

Заголовок Api-Key с текущим (меняемым) токеном.

Запрос

Без параметров и тела.

Примеры

cURL

curl -X POST \
  -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/me/reset-token

Python

import os, requests

response = requests.post(
    "https://api.telesint.dev/v1/me/reset-token",
    headers={"Api-Key": os.environ["API_KEY"]},
    timeout=10,
)
response.raise_for_status()
new_token = response.json()["token"]

JavaScript

const res = await fetch('https://api.telesint.dev/v1/me/reset-token', {
  method: 'POST',
  headers: { 'Api-Key': process.env.API_KEY },
});
const { token: newToken } = await res.json();

Ответ — 200 OK

{
  "token": "abc123def456ghi789jkl012mno345pq"
}

Поля

Поле	Тип	Описание
token	string	Новый API-токен. Используйте как Api-Key во всех последующих запросах.

Ошибки

Общие форматы — см. Ошибки.