Аутентификация

Токены API создаются и управляются из боковой панели сервера в панели управления TicketsX. Каждый токен привязан к одному серверу, и для создания или использования токена серверу нужна активная подписка Premium.

Создание токена

Подключи серверу Premium на странице Premium (со страницы «Доступ к API» есть прямая ссылка).
Открой боковую панель сервера и перейди в Доступ к API.
Назови токен (например, «Бот поддержки» или «Синхронизация с CRM»).
Нажми Создать токен и скопируй показанное значение.
Положи его в хранилище секретов: после закрытия баннера посмотреть его снова не получится.

Если Premium закончится

Токены не удаляются. Все запросы к API начинают возвращать 402 с полем premium_required: true, а создание и замена токенов блокируются, пока подписка снова не станет активной. Просмотр, отключение и отзыв продолжают работать, так что навести порядок получится в любом случае. Обрабатывай 402 в своей интеграции так же, как 401: прекрати повторные попытки и сообщи человеку.

Ответ, когда у сервера нет Premium

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

Отзыв токена сразу делает его недействительным для всех конечных точек. Если простой недопустим, сначала создай замену.

Использование токена

Передавай токен в заголовке Bearer при каждом запросе. Все запросы относятся к серверу, на котором токен создан.

Пример запроса с аутентификацией

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  https://api.ticketsx.xyz/<guild_id>/api/tickets