Запуск

API: обзор

Stable

Что умеет API v2 и как использовать его в клиентской автоматизации.

Обновлено: 6 апреля 2026 г.

API v2 - это публичный HTTP-интерфейс SPG99 для управления аккаунтом, tenants и базами данных.

Base URL

https://provisioner.spg99.ru/v2

Если вашей команде выдан отдельный контур, используйте адрес, указанный в Console или приглашении.

Что делает API

Через API обычно:

  • создают tenant и базы;
  • получают credentials и dsn_template;
  • читают состояние ресурсов;
  • запускают экспорт БД;
  • удаляют ненужные ресурсы;
  • строят автоматизацию вокруг inventory и provisioning.

Что не делает API

Прикладные PostgreSQL-подключения идут не в API, а в Gateway на :5432. Это ключевой принцип платформы: управление ресурсами отделено от клиентского SQL-трафика.

Базовый managed-сценарий

Нормальный рабочий путь такой:

create tenant -> save credentials -> create db -> connect through Gateway

Дальше платформа сама обеспечивает автоматический запуск базы при первом подключении и перевод в idle после простоя.

Какие поля особенно полезны

Для повседневной работы и автоматизации обычно достаточно смотреть на:

  • state;
  • профиль базы;
  • активность подключений;
  • время последнего использования.

Это даёт ровно ту информацию, которая нужна пользователю: база готова, простаивает или требует внимания.

Почему SPG99АрхитектураПлан развитияДокументацияЦеныБлог