Справочник разработчика

API и руководства. Всё в одном месте.

Быстрый доступ к эндпоинтам, примерам кода и инструкциям по настройке. Никаких лишних панелей — только терминал, curl и документация, которая работает.

Схема API Примеры кода

$ glidely init --region=msk-01
$ glidely deploy api-gateway --tag=v2.4.1
→ Поднята нода msk-01-04 (8 vCPU / 32GB NVMe)
→ IP 91.108.112.44 привязан, VPC создана
→ Готово за 42 сек. Уptime: 99.99%

Быстрый старт

Базовые примеры кода

Создайте VPS, подключитесь по SSH и настройте сеть — за несколько команд. Все примеры используют API-ключ из переменной окружения GLIDELY_TOKEN.

curl

Создать VPS

curl -X POST https://api.glidely.io/v1/vps \
  -H "Authorization: Bearer $GLIDELY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "region": "frankfurt",
    "plan": "dedicated-m4",
    "os": "debian-12",
    "ipv6": true
  }'

Python

Список серверов

import requests

r = requests.get(
    "https://api.glidely.io/v1/vps",
    headers={"Authorization": f"Bearer {token}"}
)
for s in r.json()["items"]:
    print(s["id"], s["region"], s["status"])

curl

Перезагрузить ноду

curl -X POST \
  https://api.glidely.io/v1/vps/vps-8f3a2c19/reboot \
  -H "Authorization: Bearer $GLIDELY_TOKEN"

Как это работает

Схема работы с API

REST-интерфейс версии 1. Все запросы — JSON, аутентификация — Bearer-токен. Базовый URL: https://api.glidely.io/v1. Лимит — 1200 запросов/мин на токен.

Аутентификация

Bearer-токен

Генерируйте ключ в консоли или через POST /v1/tokens. Токен передаётся в заголовке Authorization: Bearer <token>. Вращение ключа — без простоя.

Эндпоинты

Ключевые пути

/vps — создание и управление серверами, /dns — зоны и записи, /network — VPC и подсети, /metrics — телеметрия по CPU, RAM и трафику.

Ответы

Статус-коды

201 — ресурс создан, 200 — успешно, 402 — не хватает средств, 429 — превышен лимит, 503 — работа над нодой. Каждое тело ответа содержит поле request_id для логов.

Вебхуки

События в реальном времени

Подпишитесь на события vps.status_changed и dns.propagated. Вебхук шлёт POST с подписью HMAC-SHA256 — проверяйте заголовок X-Glidely-Signature.

Идемпотентность

Повторные запросы

Передавайте заголовок Idempotency-Key при создании ресурсов. Дубликаты вернут тот же объект вместо ошибки 409 — удобно при ретраях.

Клиенты

Готовые SDK

Официальные библиотеки для Python (glidely-sdk), Go и Node.js. Все сгенерированы из OpenAPI-спеки, обновляются вместе с API.

Сеть

Управление DNS и сетью

Полный контроль над зонами, записями и виртуальными частными сетями. Изменения распространяются по всему миру за 30–90 секунд.

DNS-зоны

Создать зону

POST /v1/dns
{ "domain": "acme.io", "ns": "auto" }

Делегирование и NS-записи настраиваются автоматически. Поддержка A, AAAA, CNAME, MX, TXT, SRV и DS.

Записи

Добавить A-запись

POST /v1/dns/acme.io/records
{ "name": "api", "type": "A",
  "value": "91.108.112.44", "ttl": 300 }

TTL от 60 секунд до 30 дней. Пакетное обновление — до 100 записей в одном запросе.

VPC

Частная сеть

Каждая VPC получает свой CIDR-блок (по умолчанию /24). Создавайте подсети, маршруты и межсетевые экраны с явными правилами.

IPv6

Двойной стек

IPv6 включён по умолчанию. Нода получает /64, вы управляете адресацией через API без пересоздания сервера.

Терминал

Терминал и SSH-доступ

Подключайтесь напрямую по SSH или через CLI-утилиту glidely. Доступ к IPMI для выделенных серверов — с двухфакторной проверкой.

SSH

Подключение

ssh root@91.108.112.44 -p 22
# или по ключу:
ssh -i ~/.glidely/id_ed25519 root@vps-8f3a2c19

Порт 22 открыт сразу после создания. Ключи — Ed25519 или RSA-4096, парольная аутентификация отключена.

CLI

Утилита glidely

glidely vps list --region msk
glidely ssh vps-8f3a2c19
glidely dns record add api A 91.108.112.44

Одна бинарная программа для всех задач. Конфигурация хранится в ~/.glidely/config.toml.

IPMI

Аппаратный доступ

Для DED-серверов — доступ к IPMI/BMC. Загрузка с внешнего носителя, контроль температуры и питание извне. Требует отдельного токена уровня admin.

Логирование

Аудит сессий

Каждая SSH-сессия и запрос к IPMI фиксируются в журнале. Экспорт логов — через GET /v1/audit с фильтром по дате и ноде.

1200

Запросов/мин лимит

<90s

Пропагация DNS

42s

Среднее время развёртывания

3

Официальных SDK

Вопросы и ответы

Где взять API-токен?

В консоли в разделе «Ключи» или через запрос POST /v1/tokens. Токен генерируется один раз и показывается полностью только при создании.

Есть ли песочная среда?

Да, режим sandbox доступен на ноде frankfurt-sbx. Все операции бесплатны и не затрагивают боевую инфраструктуру.

Как мигрировать существующие DNS-зоны?

Загрузите зону файлом zone.txt через POST /v1/dns/import. Мы импортируем все записи и выставим NS-серверы Glidely.

Поддерживается ли Windows в терминале?

Да. Для Windows-нод доступен RDP через прокси-порт 3389 и полный доступ к API для управления дисками и снапшотами.

Начать разработку

Создайте аккаунт и получите API-токен за 2 минуты. Первые 24 часа на ноде frankfurt-sbx — бесплатно.

Создать аккаунт

Нужна помощь с интеграцией

Инженеры Glidely помогут с настройкой CI/CD, Terraform-провайдера и приватных облаков. Напишите нам.

Связаться с нами