Ротація 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 у всіх подальших запитах.

Помилки

Загальні формати — див. Помилки.