Компьют
POST /v1/instances — создание виртуальных машин с выбранным профилем (kr-c2, kr-c4, kr-gpu-a100). DELETE /v1/instances/{id} с опцией retain_volumes=true для сохранения данных.
Разработчикам
API и SDK, которые встраиваются в ваш стек
Один REST-интерфейс и четыре нативные библиотеки. Управляйте ресурсами, настраивайте webhooks и автоматизируйте инфраструктуру — без ручной рутины.
REST · idempotency · rate-limit 1200 req/мин · 99,99% SLA
Успешных запросов за сутки1 284 302
Средняя задержка API38 мс
Библиотеки, которые уже используют
Python
Go
Java
Node.js
Terraform
Аутентификация
Токены и ключи API
Гибкая модель прав: от полного доступа до разовых сессий. Ключ хранится в заголовке, а действия проверяются по scope.
Каждый проект имеет два типа ключей: секретный ключ (kr_live_…) для серверного кода и публичный ключ (kr_pub_…) для фронтенда и webhooks. Секретный ключ никогда не покидает ваш бэкенд.
Все запросы подписываются заголовком Authorization: Bearer kr_live_…. Поддерживаются scope: read, write, admin и webhooks. Ключ можно ограничить по IP и TTL — например, выдать токен на 15 минут для CI-пайплайна.
При каждом запросе мы проверяем подпись и rate-limit. Ответы содержат заголовки X-RateLimit-Remaining и Retry-After, чтобы клиент корректно обрабатывал 429.
Эндпоинты управления
Создавайте и удаляйте ресурсы одним вызовом
Предсказуемый REST-интерфейс с идиоматичными именами и стабильными версиями. Все операции идемпотентны — дубли не создадут лишние объекты.
Хранилище
POST /v1/volumes — диски NVMe от 40 до 20 000 ГБ. POST /v1/volumes/{id}/snapshots — мгновенные снапшоты, доступные для отката и клонирования.
Сети и балансировка
POST /v1/vpcs, POST /v1/subnets, POST /v1/load-balancers. Поддерживаются внутренние и публичные адреса, TLS-терминация и health-check по кастомным путям.
Автоскейлинг
POST /v1/scaling-groups — группы с целевым CPU, памятью или кастомной метрикой из Prometheus. GET /v1/scaling-groups/{id}/events — история расширений и сжатий.
Мониторинг
GET /v1/metrics/{resource} — 120+ метрик с шагом от 10 секунд. GET /v1/logs/{id}?since=… — потоковое чтение логов через SSE-канал.
Идемпотентность
Передавайте заголовок Idempotency-Key (UUID) — повторный вызов вернёт тот же результат. Удобно для ретраев в CI и для безопасных «повторных» деплоев.
Webhooks
Уведомления об изменениях в реальном времени
Подписывайтесь на события и получайте JSON-пуши на свой эндпоинт. Подпись X-Kronly-Signature защищает от подделок.
Создайте вебхук через POST /v1/webhooks с URL и списком событий: instance.created, instance.terminated, scaling.expanded, volume.snapshot_ready, alert.critical и другие. Максимум 50 вебхуков на проект.
Каждое тело подписано HMAC-SHA256 ключом вебхука — проверяйте заголовок X-Kronly-Signature перед обработкой. При неудачной доставке мы повторяем запрос по экспоненциальной задержке (30 с, 2 мин, 10 мин, 1 ч) до 6 попыток.
В консоли доступен журнал доставок: статус, задержка, тело запроса и ответ. Можно вручную «переслать» любое событие — полезно при отладке пайплайнов.
SDK
Нативные библиотеки для вашего стека
Официальные клиенты с типами, ретраями, пагинацией и примерами. Обновляем синхронно с API — разрыв совместимости не раньше чем через 12 месяцев.
Python
kronly-cloud · v2.4.1 · 38 200 инсталлаций/нед. Async и sync API, контекст-менеджеры, dataclasses для типов. Поддержка Python 3.9–3.12.
Go
github.com/kronly/go-sdk · v1.9.0 · 12 400 репозиториев. Чистый stdlib, без внешних зависимостей. Генерируемые модели и context-aware методы.
Java
com.kronly:cloud-sdk · v3.2.2 · Maven / Gradle. Kotlin-friendly API, Java 11+, реактивный клиент на Base-флаге. Полный javadoc и sample-проекты.
Node.js
@kronly/sdk · v2.1.4 · 21 700 инсталлаций/нед. TypeScript-first, ESM и CJS, автоматическая пагинация и retry с backoff. Примеры для Deno и Bun.
38мс
Средняя задержка API (p50)
1200/мин
Лимит запросов на ключ
4
Официальных SDK
99,98%
Доставка webhooks
Вопросы разработчикам
Коротко о главном
То, что чаще всего спрашивают перед тем, как подключиться.
В консоли — раздел «Ключи API». Можно создать до 10 ключей, задать scope (read, write, admin), ограничить по IP и TTL. Секретный ключ показывается только один раз при создании.
Заголовок X-Kronly-Signature содержит HMAC-SHA256 от тела запроса с использованием секрета вебхука. В документации и в каждом SDK есть готовые функции verifySignature(body, signature, secret).
Да. Отдельный хост sandbox.api.kronly.cloud с ключами kr_test_…. Все операции бесплатны, ресурсы создаются мгновенно и живут 24 часа. Идеально для CI и автотестов.
При 429 возвращается заголовок Retry-After в секундах. Все SDK делают экспоненциальный backoff с джиттером и не более 5 попыток. Для идемпотентных операций можно передавать Idempotency-Key — повторный вызов вернёт тот же ответ.
Да. Официальный провайдер kronly в Terraform покрывает 90% ресурсов. Для Kubernetes — оператор kronly-operator и Helm-чарты для типовых сценариев (web, worker, queue, db).
Подключите API
Начните кодить за 5 минут
Создайте ключ, выберите SDK и разверните первый ресурс. Песочница — бесплатно и без карты.
Сandbox · 1200 req/мин · 4 SDK · Terraform-провайдер
Нажимая кнопку, вы соглашаетесь с политикой конфиденциальности.