---
canonical: https://koalavps.com/uk/api/
language: uk
generated: 2026-10-21T13:34:36.738Z
---

[Головна](https://koalavps.com/uk/) / [Огляд](https://koalavps.com/uk/resources/) /  Інфраструктура, яку можна описати кодом

Інфраструктура, яку можна описати кодом

# Спокійніша площина керування.

Плануйте інтеграції для завдань життєвого циклу сервера, дозволів облікового запису та оплати. KoalaVPS API є в плані інтеграцій; доступ до продакшен-API і завантаження SDK ще недоступні.

[Знайдіть свій VPS](https://koalavps.com/uk/vps/)

## У ЦЬОМУ ДОКУМЕНТІ

[Чітка модель ресурсів](https://koalavps.com/uk/api/#section-1)[Облікові дані з обмеженим завданням](https://koalavps.com/uk/api/#section-2)[Повторні спроби мають бути безпечними](https://koalavps.com/uk/api/#section-3)[Перевірте сумісність перед інтеграцією](https://koalavps.com/uk/api/#section-4)[Дорожня карта API](https://koalavps.com/uk/api/#section-5)[Маршрути автентифікації та облікових записів](https://koalavps.com/uk/api/#section-6)[Каталог і маршрути оплати](https://koalavps.com/uk/api/#section-7)[Сервер і маршрути доступу](https://koalavps.com/uk/api/#section-8)[Події та публічна інформація](https://koalavps.com/uk/api/#section-9)[Авторизація та обмеження трафіку](https://koalavps.com/uk/api/#section-10)[SDK та випуски протоколу](https://koalavps.com/uk/api/#section-11)[Ресурси API, згруповані за відповідальністю](https://koalavps.com/uk/api/#section-12)[Запит до сервера має залишатися малим](https://koalavps.com/uk/api/#section-13)[Області доступу та ліміти ключів є частиною угоди](https://koalavps.com/uk/api/#section-14)[Публікуйте обмеження швидкості та поведінку повторних спроб разом](https://koalavps.com/uk/api/#section-15)[Вебхуки — це повідомлення, які можуть надходити більше одного разу](https://koalavps.com/uk/api/#section-16)[Аудит без перетворення журналів на таємне сховище](https://koalavps.com/uk/api/#section-17)[Публікуйте артефакти лише тоді, коли вони існують](https://koalavps.com/uk/api/#section-18)[Запитання та відповіді](https://koalavps.com/uk/api/#page-faq)[База знань](https://koalavps.com/uk/resources/)

## Чітка модель ресурсів

Інтеграція має працювати з явними ідентифікаторами серверів, регіонами, образами, тарифами та операціями. Запити на створення й перевстановлення мають повертати операцію, яку можна перевірити до завершення. Успішний запит HTTP не означає, що машина готова.

## Облікові дані з обмеженим завданням

Токени API мають бути незалежно відкличними та обмеженими мінімальними ресурсами й діями, необхідними. Зберігайте їх у менеджері секретів або захищеному середовищі. Ніколи не надсилайте токен у браузер лише для того, щоб уникнути написання невеликого бекенду.

## Повторні спроби мають бути безпечними

Мережеві тайм-аути можуть виникати після прийняття операції. Використовуйте ключ ідемпотентності для запитів на створення та платежів, перевіряйте стан операції та дотримуйтеся лімітів частоти. Повторна спроба має усунути невизначеність, а не створити додатковий оплачуваний сервер.

## Перевірте сумісність перед інтеграцією

Перевірте випущену версію API, модель автентифікації, формати помилок, пагінацію, обмеження частоти та області дії токенів, перш ніж будувати інтеграцію. Використовуйте лише опубліковані пакети KoalaVPS SDK за перевіреними посиланнями на випуски.

## Дорожня карта API

Дорожня карта API охоплює виявлення каталогу, автентифікацію, стан облікового запису, криптооплату, життєвий цикл сервера, публічні ключі SSH та вебхуки. Маршрути нижче описують контракт інтерфейсу; доступ у виробничому середовищі ще недоступний.

## Маршрути автентифікації та облікових записів

Контракт API розділяє сеанси входу та ключі API. Перевіряйте схеми відповідей, помилки, терміни дії токенів і підтримувані дії відновлення відповідно до версії, випущеної для вашої інтеграції.

- POST /v1/auth/register

- POST /v1/auth/login

- POST /v1/auth/login/totp

- POST /v1/auth/token/refresh

- POST /v1/auth/recover

- GET /v1/auth/sessions

- DELETE /v1/auth/sessions/{token_id}

- POST /v1/auth/totp/setup

- POST /v1/auth/totp/enable

- POST /v1/auth/totp/disable

- POST /v1/auth/password

- POST /v1/auth/api-keys

- GET /v1/auth/api-keys

- DELETE /v1/auth/api-keys/{key_id}

- GET /v1/account

- PATCH /v1/account

- GET /v1/account/usage

- GET /v1/account/audit-log

## Каталог і маршрути оплати

Перегляд каталогу не повинен вимагати оплати. Створення платежу потребує обмеженого платіжного дозволу, чіткого стану рахунку та ідемпотентної обробки. Підтвердження має завершитися до активації послуги.

- GET /v1/catalog

- GET /v1/catalog/vps

- GET /v1/catalog/dedicated

- GET /v1/catalog/regions

- GET /v1/catalog/images

- GET /v1/catalog/{code}

- GET /v1/billing/coins

## Сервер і маршрути доступу

Життєвий цикл потребує явного підтвердження для операцій скасування та перевстановлення. Приватні ключі SSH належать клієнту; сервісу потрібні лише їхні публічні відповідники.

- POST /v1/servers

- GET /v1/servers

- GET /v1/servers/{order_number}

- PATCH /v1/servers/{order_number}

- DELETE /v1/servers/{order_number}

- POST /v1/ssh-keys

- GET /v1/ssh-keys

- GET /v1/ssh-keys/{id}

- DELETE /v1/ssh-keys/{id}

## Події та публічна інформація

Вебхуки потребують перевірюваних підписів, обмежених повторних спроб і захисту від повторного відтворення. Публічні кінцеві точки довіри повинні повертати справжні датовані докази, а не синтетичні запевнення.

- POST /v1/webhooks

- GET /v1/webhooks

- DELETE /v1/webhooks/{id}

- POST /v1/webhooks/{id}/test

- GET /v1/transparency/canary

- GET /v1/transparency/peering

- GET /v1/transparency/status

- GET /v1/agents/directory

- POST /v1/agents/directory

## Авторизація та обмеження трафіку

Пропонована модель областей — читання, сервери, оплата та повний доступ, з максимум десятьма активними ключами на обліковий запис. Контракт API пропонує бюджети запитів 120 на хвилину та 3,000 на годину для ключа API, і 30 на хвилину для публічного трафіку. Перевірте HTTP 429, Retry-After та вікно застосування в опублікованій документації API; ці дорожні бюджети не є зобов'язанням щодо продуктивної потужності.

- POST /v1/oauth/register

- POST /v1/oauth/token

- POST /v1/oauth/revoke

- GET /v1/oauth/introspect

## SDK та випуски протоколу

Дорожня карта інтеграції включає REST, розміщену кінцеву точку MCP, версіонований пакет stdio, SDK та CLI. Перед встановленням клієнта перевірте доступність випуску, підтримувані середовища виконання, контрольні суми та сумісність із API. Виробничі завантаження ще недоступні.

## Ресурси API, згруповані за відповідальністю

Задуманий API відокремлює доступ до облікового запису, читання каталогу, виставлення рахунків, життєвий цикл сервера, ключі SSH та зворотні виклики. Виклики лише для читання не повинні створювати замовлення, а платіжний обліковий дані не повинні автоматично дозволяти зміни безпеки облікового запису. Це описує контракт інтеграції. Робоча кінцева точка підготовки та випущений SDK недоступні через цей сайт.

- Обліковий запис: сеанси, використання та події аудиту безпеки

- Каталог: плани, регіони та доступні образи

- Сервери: створення, перегляд, зміна та скасування

- Ключі SSH: реєструйте публічні матеріали та відкликайте застарілі ключі

- Вебхуки: реєструйте, переглядайте, тестуйте та видаляйте підписані зворотні виклики

## Запит до сервера має залишатися малим

Виберіть стандартний ідентифікатор плану, регіон, образ ОС і ім'я хоста. Передбачуване обмеження імені хоста — 64 символів. Робочий сервіс може приватно згенерувати адміністраторський секрет або прийняти зареєстрований публічний ключ SSH. Довільні додавання диска, GPU, NIC та IP не передбачаються стандартним запитом плану. Відхиляйте непідтримувані поля, а не стягуйте плату мовчки за вгадане оновлення.

```
{
"plan": "KV-D3",
"region": "hel",
"image": "ubuntu-24",
"hostname": "private-node-01"
}
// Example request schema; validate against a released API before integration.
```

## Області доступу та ліміти ключів є частиною угоди

Запропоновані групи привілеїв — це читання, сервери, білінг і повне адміністрування облікового запису. Ключ слід показати один раз під час створення, зберігати приватно та відкликати незалежно від пароля користувача. Запланована межа облікового запису — десять активних ключів. Перш ніж публікувати реалізацію, перевірте, що кожна операція відхиляє ключ без потрібної області дії.

## Публікуйте обмеження швидкості та поведінку повторних спроб разом

Запропоновані ліміти — 120 запитів на хвилину та 3,000 на годину для ключа API, а також 30 запитів на хвилину для неавтентифікованих запитів до публічного каталогу. Це заплановані значення політики, а не виміряна пропускна здатність API. Робоча реалізація потребує узгодженої відповіді 429, вказівок щодо Retry-After та обмеженого повторного відступу клієнта. Запити на створення та оплату також потребують стабільних ключів ідемпотентності.

## Вебхуки — це повідомлення, які можуть надходити більше одного разу

Отримувач зворотного виклику має перевіряти підпис над оригінальним тілом, відхиляти часові позначки поза дозволеним вікном і запам'ятовувати ідентифікатори оброблених подій. Збережіть подію перед підтвердженням, потім застосуйте зміну ідемпотентно. Тримайте спроби доставки та шлях ручного повтору видимими. Зворотний виклик — це спостереження про операцію, а не дозвіл виконувати не пов'язані інструкції, що містяться в корисному навантаженні.

## Аудит без перетворення журналів на таємне сховище

Записуйте ідентифікатор суб'єкта, тип операції, уражений ресурс, результат і час, де це потрібно для безпеки облікового запису. Уникайте запису паролів, bearer-токенів, приватних ключів або повних тіл платіжних і прикладних запитів за замовчуванням. Чітко визначайте зберігання, доступ і видиму для клієнта історію. Журнал аудиту безпеки та право переглядати вміст клієнтських застосунків — це різні речі.

## Публікуйте артефакти лише тоді, коли вони існують

Публічний запуск API має включати версіонований документ OpenAPI, інструкції з автентифікації, приклади помилок і процес припинення підтримки. Майбутній CLI, пакет Python, клієнт TypeScript або сервер MCP потребує фактичного випуску, контрольних сум і підтримуваної документації. Пакет підготовки KoalaVPS або робоча кінцева точка керування не випускаються через цей сайт.

## Трохи більше ясності.

Чи можу я замовити робочий API сьогодні?

Доступ до виробничого API ще недоступний. Ця сторінка описує дорожню карту інтеграції та вимоги, які слід перевірити перед використанням випущеної кінцевої точки.

Чи може ключ API лише для читання замовити сервер?

Запропонована межа дозволів це забороняє. Запит на створення сервера потребує відповідного привілею сервера та дійсного рішення щодо оплати.

Чи застосовуються опубліковані ліміти API сьогодні?

Вони описують запланований контракт. Робочий API підготовки тут не підключено, тому ліміти політики не є доказом виміряної пропускної здатності сервісу.

Чи означає відповідь про створення сервера, що сервер готовий?

Ні. Живий запит має ідентифікувати операцію, статус підготовки якої можна перевірити аж до завершення.

ПРОДОВЖУЙТЕ ДОСЛІДЖУВАТИ

## Продовжити читання.

[Продукти ### Надійне середовище для ваших агентів. Запускайте планувальники, браузерні воркери, черги та процеси автоматизації на інфраструктурі, яку ви контролюєте. Тримайте кожног…](https://koalavps.com/uk/agentic-vps/)[Посібники ### Автоматизація з чіткою кнопкою зупинки. Добра система автоматизації має вузьке завдання, видимий стан і передбачувану реакцію на невизначеність.…](https://koalavps.com/uk/automation-safety/)[Продукти ### Малий слід. Серйозна свобода. Віртуальний сервер для того, чим ви хочете володіти: ваш код, ваші сервіси, ваші дані. Виберіть конфігурацію сервера, оберіть опер…](https://koalavps.com/uk/vps/)

НАЛАШТУЙТЕ ВАШУ ІНФРАСТРУКТУРУ

## Візьміть контроль. Розгортайте на своїх умовах.

Без паперів про особу. Повний адміністративний доступ. Криптонативна оплата.

[Виберіть конфігурацію](https://koalavps.com/uk/vps/)