Методы API

ИИ-персонажи

Список своих ИИ-персонажей и персонаж по ID для ответов на донаты.

Методы возвращают только персонажей владельца токена. Если стример скрыл промпты в настройках, prompt и systemPrompt приходят как null.

Список персонажей

GEThttps://donatex.gg/api/v1/ai/characters

Персонажи владельца токена, включая неактивных. Удалённые не возвращаются. Сортировка — по имени, затем по ID; если персонажей нет, вернётся [].

OAuth-токену нужен scope user.read. External token работает без scopes.

Ответы

iduuid

ID персонажа

namestring

Имя персонажа

promptstring | null

Промпт персонажа; null, если стример скрыл промпты

systemPromptstring | null

Системный промпт; null, если он не задан или промпты скрыты

avatarUrlstring | null

URL аватара; null, если аватара нет

colorstring

Цвет персонажа из настроек

Общие для всех методов: 401 — нет токена или он недействителен, 403 — у OAuth-токена нет нужного scope, 429 — превышен лимит запросов. Подробнее об ошибках

GET/v1/ai/characters

curl "https://donatex.gg/api/v1/ai/characters" \
  -H "Authorization: Bearer $DONATEX_TOKEN"

[
  {
    "id": "42e114f7-0ac2-468c-b769-b26963abf81d",
    "name": "Капитан",
    "prompt": "Ты — добродушный капитан. Отвечай коротко и подшучивай над неудачами в игре.",
    "systemPrompt": "Отвечай по-русски.",
    "avatarUrl": "https://cdn.donatex.gg/aiassistant-widgets/avatars/captain.png",
    "color": "#B69CFF"
  }
]

Персонаж по ID

GEThttps://donatex.gg/api/v1/ai/characters/{id}

Возвращает персонажа, только если он принадлежит владельцу токена. Его ID можно передать в aiPresetId тестового доната.

OAuth-токену нужен scope user.read. External token работает без scopes.

Path-параметры

iduuidобязательный

ID своего персонажа