Ошибки, лимиты и правила интеграции

Control Plane API рассчитан на автоматизацию, поэтому его ответы должны быть предсказуемыми и пригодными для скриптов, CI/CD и внутренних сервисов.

Как читать ошибки

На практике чаще всего встречаются:

• 400 - некорректный запрос или не прошла валидация;
• 401 - токен отсутствует или неверен;
• 403 - у токена не хватает прав;
• 404 - ресурс не найден или недоступен;
• 409 - операция сейчас недоступна из-за состояния ресурса или лимита;
• 5xx - внутренняя ошибка платформы, стоит повторить запрос и проверить статус ресурса позже.

Практические правила интеграции

• считайте создание, удаление и экспорт асинхронными операциями;
• сохраняйте dsn_template и credentials сразу после выдачи;
• не стройте логику на внутренних адресах или worker-идентификаторах;
• при повторах используйте идемпотентность и разумные retry;
• для состояния базы ориентируйтесь на state и профиль, а не на внутренние подробности платформы.

Что учитывать по лимитам

У аккаунта и тарифа могут быть ограничения по числу tenants, баз, compute-ресурсу и сетевому трафику. Поэтому хороший production-процесс всегда включает проверку лимитов до массового provisioning.

Самый устойчивый подход - интегрироваться со SPG99 как с управляемой платформой: работать через account, tenant, database и доверять платформе lifecycle-операции, которые она берёт на себя сама.