API / Начало работы / Обзор API

Обзор API

API sourhost — это те же действия, что в панели, но для ваших скриптов, ботов и CI: смотреть серверы, перезапускать их, править конфиги, продлевать аренду. Обычный HTTP и JSON.

Адрес

Все методы находятся по адресу:

HTTP

https://sourhost.net/api/v1

v1 — стабильная версия. Новые поля в ответах могут появляться, существующие не меняются и не пропадают.

Авторизация

Каждый запрос подписывается личным API-токеном в заголовке Authorization. Токен создаётся в «Настройки» → «API-токены», подробнее — в статье API-токены.

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

Ответ:

HTTP

HTTP/2 200 OK
{
  "id": 27,
  "email": "[email protected]",
  "balance": 1250,
  "timezone": "Europe/Kyiv"
}

Храните токен как пароль: в переменных окружения или менеджере секретов, не в коде и не в репозитории. Утёк — отзовите его в настройках, он перестанет работать сразу.

Формат

Что	Как
Тело запроса	JSON, заголовок `Content-Type: application/json`. Исключение — тикеты поддержки, там поля формы
Ответ	JSON. Успешный ответ без тела — статус `204`
Деньги	Целые гривны (UAH)
Даты	ISO 8601 в UTC, например `2026-12-01T00:00:00Z`
Номера	Строки с числом, например `"34"`: берите их из ответов списков

С чего начать

Создайте токен с нужными правами — API-токены.
Найдите проект и сервер: GET /projects, затем GET /projects/:id/services — справочник.
Управляйте сервером — управление сервером.
Разберитесь с ошибками и лимитами.