DonateXdev.

ВойтиСоздать приложение

Методы API

Цели сбора

Активная цель сбора стримера: название, прогресс и сумма в рублях.

Активная цель

GEThttps://donatex.gg/api/v1/goals/current

Возвращает активную цель сбора. Суммы всегда в рублях.

Если активной цели нет, вернётся 404 с кодом goal_not_found — это штатная ситуация, а не сбой.

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

Ответы

iduuid

ID активного пресета цели

namestring

Название цели

currentAmountnumber

Собрано, RUB

goalAmountnumber

Цель, RUB

currencystring

Всегда RUB

progressPercentnumber

Процент выполнения с двумя знаками; может быть больше 100

isCompletedboolean

Достигнута ли цель

Active donation goal not found

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

GET/v1/goals/current
curl "https://donatex.gg/api/v1/goals/current" \
  -H "Authorization: Bearer $DONATEX_TOKEN"
{
  "id": "a19b8d6d-2e35-4d74-a28d-0b4f6d8ba5f1",
  "name": "Новый микрофон",
  "currentAmount": 12450.00,
  "goalAmount": 20000.00,
  "currency": "RUB",
  "progressPercent": 62.25,
  "isCompleted": false
}