Первый запрос к публичному API

Всё, что вы делаете в личном кабинете, можно сделать и через REST API. Это полезно для автоматизации (Terraform, CI/CD-пайплайны, скрипты бэкапа).

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

1. Откройте Настройки → API-токены. 2. Нажмите «Создать токен», дайте имя (типа ci-deploy или terraform-prod). 3. Выберите скоупы (vps:read, vps:write, domain:read, billing:read, * для админ-доступа). 4. Установите expiry (рекомендуем 30–90 дней). 5. Сразу скопируйте показанный токен — после закрытия диалога он не отображается повторно.

Формат токена: pat_<hex>.

Первый запрос — список ваших VPS

curl -H "Authorization: Bearer pat_xxxxxxxx" \
  https://elistrax.com/api/services?type=vps

Ответ:

{
  "items": [
    {
      "id": "vps_01HKQM...",
      "type": "vps",
      "status": "active",
      "region": "de-nbg1",
      "name": "web-01",
      "metadata": { "ip4": "203.0.113.42" },
      ...
    }
  ]
}

Создать VPS

curl -X POST -H "Authorization: Bearer pat_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_code": "std-s1",
    "region": "de-nbg1",
    "billing_cycle": "hourly",
    "metadata": {
      "hostname": "api-test-01",
      "os_template": "ubuntu-24.04",
      "ssh_keys": ["ssh-ed25519 AAAA..."]
    }
  }' \
  https://elistrax.com/api/services

Получите 202 Accepted + service_id. Дёргайте GET /services/{id} пока status не станет active.

Idempotency-Key

Все mutating-запросы поддерживают заголовок Idempotency-Key: <uuid> — это гарантирует, что повтор одного запроса с тем же ключом не создаст дубликат услуги. Срок жизни ключа — 24 часа.

curl -X POST -H "Authorization: Bearer pat_xxxxxxxx" \
  -H "Idempotency-Key: 0a8a3a40-bf42-4c81-9c1f-bd9bcaa12345" \
  ...

Коды тарифов и регионов

Актуальные коды для API: тарифы — std-s1/s2/m1/m2/l1/xl1 (стандартная линейка, Германия/Финляндия), perf-2/4/8/16/32 (dedicated vCPU, есть США и Сингапур), cbo-vps-10/20/30, cbo-store-10/20/30, cbo-vds-s/m/l (CB-линейка, Германия). Регионы — de-nbg1, de-fsn1, fi-hel1, us-ash, us-hil, sg-sin, de-nue. Полный список с доступностью отдаёт GET /api/plans — рекомендуем выбирать из него, а не хардкодить.

CLI и SDK

CLI (cloudhost) и SDK для TypeScript и Go — в закрытой бете. Напишите в поддержку, вышлем сборку под вашу платформу.

Для любого языка можно сгенерировать типизированный клиент из OpenAPI-схемы (openapi-generator, openapi-python-client): https://elistrax.com/openapi.yaml.

Rate-limit

60 req/min на токен по умолчанию. При превышении — 429 Too Many Requests с заголовком Retry-After. Если нужен выше лимит — напишите в поддержку с обоснованием use-case.