Акаунт

Профіль, баланс, зведення й налаштування сповіщень.

Адреса:https://sourhost.net/api/v1·Авторизація: Authorization: Bearer sh_live_…

GET/me— Акаунт і баланс GET/dashboard/summary— Зведення GET/settings— Налаштування сповіщень PATCH/settings— Змінити налаштування PATCH/profile— Змінити профіль GET/referral— Реферальна програма

GET/me

Акаунт і баланс

Право: account:read

Приклад запиту

curl "https://sourhost.net/api/v1/me" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Відповідь

HTTP

HTTP/2 200 OK
{
  "id": 27,
  "email": "[email protected]",
  "name": "Олег",
  "balance": 1250,
  "timezone": "Europe/Kyiv",
  "locale": "uk",
  "role": "user"
}

GET/dashboard/summary

Зведення

Проєкти, активні послуги, витрати на місяць і найближча оплата.

Право: account:read

Приклад запиту

curl "https://sourhost.net/api/v1/dashboard/summary" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Відповідь

HTTP

HTTP/2 200 OK
{
  "monthlyTotal": 900,
  "projects": 2,
  "activeServices": 3,
  "openTickets": 0,
  "nextPaymentAt": "2026-12-01T00:00:00Z"
}

GET/settings

Налаштування сповіщень

Право: account:read

Приклад запиту

curl "https://sourhost.net/api/v1/settings" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Відповідь

HTTP

HTTP/2 200 OK
{
  "email_notification": true,
  "telegram_notification": false,
  "renewal_reminders": true,
  "auto_pay": false
}

PATCH/settings

Змінити налаштування

Право: account:write

Приклад запиту

curl -X PATCH "https://sourhost.net/api/v1/settings" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"renewal_reminders":true,"auto_pay":true}'

Відповідь

204 Порожня відповідь

PATCH/profile

Змінити профіль

Право: account:write

Приклад запиту

curl -X PATCH "https://sourhost.net/api/v1/profile" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Олег","phone":"+380501234567","timezone":"Europe/Kyiv"}'

Відповідь

204 Порожня відповідь

GET/referral

Реферальна програма

Право: account:read

Приклад запиту

curl "https://sourhost.net/api/v1/referral" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Відповідь

204 Порожня відповідь

Загальні помилки

Будь-який метод може відповісти так. Докладніше про помилки

400	`bad_request`	Невірне тіло чи параметри
401	`token_invalid`	Токен невірний, відкликаний або прострочений
403	`token_scope_missing`	У токена немає потрібного права
403	`token_project_forbidden`	Проєкт чи послуга поза обмеженнями токена
404	`not_found`	Немає такого проєкту, послуги чи об’єкта
429	`token_rate_limited`	Забагато запитів, див. Retry-After
503	`upstream_unavailable`	Панель або нода не відповіли — повторіть пізніше