Семантическое версионирование. Ломающие изменения (переименование полей, удаление endpoint, смена схемы аутентификации) выпускаются только в новой мажорной версии с новым префиксом URL /v2/. Внутри /v1/ возможны только аддитивные изменения (новые опциональные поля, новые endpoint).
v1.4.0 (2026-11-09)
- Новый маршрут GET /v1/services/{id}/metrics (право read:services): метрики сервера для периодов 1h, 6h, 24h, 7d и 14d. Edge Unlimited Traffic VPS предоставляют данные о CPU, памяти, сети и исходящем трафике, обычные Unlimited Traffic VPS предоставляют данные о входящем и исходящем сетевом трафике в локациях, перечисленных в справочнике эндпоинтов.
- Новые маршруты GET /v1/services/{id}/ddos/attacks и GET /v1/services/{id}/ddos/attacks/{attack_id} (право read:ddos): отчёты об атаках для Remote DDoS Protection глубиной до 90 дней, с графиком трафика и разбивкой по протоколу, порту, источнику и размеру пакетов.
- Профили и правила (/ddos/profiles, /ddos/rules и операции записи): услуга вашего аккаунта, которая не является услугой Advanced DDoS Protection, теперь возвращает HTTP 409 not_supported_for_product вместо HTTP 404. Неизвестные или чужие ID услуг по-прежнему возвращают HTTP 404.
v1.3.1 (2026-11-02)
- Германию и Францию можно выбрать отдельно: «Германия (Европа)» означает размещение только в Германии (Франкфурт), а «Франция (Европа)» только во Франции.
- Подготовка обычных Unlimited Traffic VPS в Европе, Германии, Франции, восточной Канаде, Великобритании и Польше может занять до 7 дней. В большинстве случаев сервер готов в течение 48 часов. Оплаченный срок начинается только после получения сервера.
v1.3.0 (2026-11-02)
- Advanced DDoS Protection: чтение профилей и правил, добавление правил и удаление собственных правил через четыре новых маршрута. Явно включите read:ddos и write:ddos; существующие ключи не получают новых прав.
- Общие лимиты панели и API, последовательное выполнение изменений и обязательный Idempotency-Key для POST и DELETE защищают от массовой отправки правил и параллельных запросов.
v1.2.2 (2026-10-27)
- POST /v1/orders: если оплаченную услугу не удаётся развернуть сразу, её ID теперь указывается в поле awaiting_setup (status awaiting_setup), а не в provisioning_failures со статусом partial. Услуга будет развёрнута автоматически, как только это станет возможно, и затем перейдёт в статус active. В этом случае не оформляйте заказ повторно.
v1.2.1 (2026-10-26)
- Dedicated Unlimited Traffic VPN: новые локации с доплатой в Европе, Северной и Южной Америке, Азии, на Ближнем Востоке, в Африке и Австралии. GET /v1/products/{id} показывает их с отображаемым названием и доплатой. Если такая локация сейчас распродана, POST /v1/orders возвращает HTTP 409 location_sold_out. Если локация не указана, по-прежнему действует первая в списке (Europe).
- Конфигурационные опции (локация и операционная система) тарифов Dedicated Unlimited Traffic VPN и Dedicated High Speed Unlimited Traffic VPN получили новые ID, как и их варианты (sub_options). Используйте ID из GET /v1/products/{id}: жёстко заданный старый ID приводит к HTTP 400 validation_failed. Для услуг этих тарифов, у которых status ещё до этого изменения имел значение cancelled, terminated или fraud, GET /v1/services/{id} отныне возвращает location со значением null. High Speed VPN теперь можно заказать только с опциями локации Europe, Germany or France, Canada East (Beauharnois), France (Europe), United Kingdom (Europe) и Poland (Europe).
- Edge Unlimited Traffic VPS: шесть новых локаций (Франкфурт-на-Майне, Лондон, Честер, Париж, Варшава и Вашингтон), всего до 25. У новых локаций свои значения sub_option_id, ID прежних локаций не изменились. В некоторых тарифах базовая цена и доплаты за локацию распределены по-новому, итоговые цены прежних локаций не изменились. ID и цены всегда получайте из GET /v1/products/{id}.
v1.2.0 (2026-10-24)
- POST /v1/orders для продуктов с выбором локации (Edge Unlimited Traffic VPS): у опции локации нет значения по умолчанию, её нужно передать в config_options, иначе HTTP 422 с reason location_required. Распроданная локация возвращает HTTP 409 location_sold_out. Новое необязательное поле storage_gb задаёт общий объём хранилища от 20 до 300 ГБ. 20 ГБ включены в цену тарифа и действуют, если поле не указано, каждый дополнительный ГБ оплачивается по цене из GET /v1/products/{id}. Другие значения дают HTTP 422 storage_out_of_range.
- Для этих продуктов результат заказа содержит location и storage_gb (общий объём хранилища в ГБ), а GET /v1/products/{id} описывает в поле storage допустимый диапазон и цену за дополнительный ГБ. GET /v1/services и GET /v1/services/{id} возвращают location и storage_gb для каждой услуги (null, если у продукта нет такого выбора).
- GET /v1/products/{id} возвращает варианты опций (sub_options) только с отображаемым названием (например, "Finland (Europe)"), без внутреннего значения перед ним. POST /v1/orders отклоняет продукты, которые сейчас распроданы, с HTTP 409 out_of_stock.
v1.1.0 (2026-09-23)
- POST /v1/orders: config_options принимает только опции и значения, видимые в магазине, а количества только в допустимых пределах. Видимые опции, которые Вы не указали, получают первое значение из списка, как и в магазине. GET /v1/products/{id} показывает только доступные для заказа опции и возвращает quantity.min и quantity.max.
- Новый статус заказа awaiting_setup с полем awaiting_setup для продуктов, которые команда KernelHost настраивает вручную. Автоматически разворачиваемые услуги разворачиваются ровно один раз.
- Размер body запросов ограничен 64 КБ (HTTP 413). Для каждого аккаунта действует общий лимит 120 запросов в минуту на все ключи, а один аккаунт может иметь до 20 активных ключей. Неудачная аутентификация больше не блокирует ключ, а Idempotency-Key привязан к методу и пути.
- Запросы с несколькими параметрами в query string (например, GET /v1/services?limit=10&offset=0) отклонялись с HTTP 401. Теперь подпись охватывает query string точно так, как описано в документации.
v1.0.0 (2026-05-14)
- Первый релиз. Все 15 endpoint, аутентификация HMAC, хранение секретов AES-GCM, ограничения частоты, идемпотентность, журнал аудита.
- GET
/v1/me,/v1/products,/v1/products/{id} - POST
/v1/orders, GET/v1/orders/{id} - GET
/v1/services,/v1/services/{id},/v1/services/{id}/credentials - POST
/v1/services/{id}/actions - GET
/v1/billing/balance,/v1/billing/invoices,/v1/billing/invoices/{id}/pdf - GET/PUT
/v1/webhooks - HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.

