Обзор
Публичный endpoint /api/health возвращает агрегированный, не содержащий секретов статус runtime и readiness платформы VPOS.am.
Текущее агрегированное состояние платформы
Виджет читает несекретный same-origin health endpoint и показывает только ограниченную публичную сводку готовности.
Что показывает публичный health
GET /api/health возвращает ok, ready, service, version, mode, generatedAt и агрегированный объект readiness. Верхнеуровневый ready подходит для общего uptime/readiness check, а blockers и warnings помогают диагностировать состояние платформы.
Текст диагностических blockers не является стабильным API-контрактом. Автоматический мониторинг должен опираться на документированные поля и сохранять generatedAt, чтобы отличать свежий ответ от устаревшего результата.
Граница агрегированного статуса
ready=true означает, что общий runtime прошел текущие platform-level проверки. Это не доказывает наличие у конкретного merchant действующего договора, credentials, installation binding, callback, fiscal profile или разрешенного production provider route.
Merchant-specific readiness подтверждается отдельно в console/onboarding flow и тестовым платежом. Состояние внешнего банка или провайдера также нельзя выводить только из общего VPOS health.
Как использовать сигнал в эксплуатации
Мониторинг может опрашивать /api/health и уведомлять operations при ready=false или отсутствии свежего ответа. Ошибки отдельного платежа, webhook delivery или provider callback нужно разбирать по payment id, merchantOrderId и журналам конкретной интеграции.
Публичный health не является обещанием SLA или историей инцидентов. Подтвержденное влияние на конкретного клиента и действия по восстановлению сообщаются через согласованные support-каналы.
Частые вопросы
Что означает ready в ответе /api/health?
Это агрегированный результат текущих platform-level readiness checks на момент generatedAt. Он подходит для общего мониторинга runtime, но не подтверждает готовность отдельного merchant или provider route.
Подтверждает ли ready=true готовность merchant к production?
Нет. Для конкретной installation отдельно проверяются договор и credentials, token binding, provider route, callbacks/webhooks, test payment и production approval.