Аккаунт

Профиль, баланс, сводка и настройки уведомлений.

Адрес: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`	Панель или нода не ответили — повторите позже