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 — довідник.
Керуйте сервером — керування сервером.
Розберіться з помилками і лімітами.