Перейти к документации
Справочник разработчика

Статус

Это platform-level сигнал для мониторинга: он показывает состояние общего runtime на момент generatedAt, но не подтверждает готовность конкретного merchant, provider route или production-запуска.

Версия
Публичный health
Проверено
Статус
Проверяем…
Навигация для разработчика
01

Обзор

Публичный endpoint /api/health возвращает агрегированный, не содержащий секретов статус runtime и readiness платформы VPOS.am.

Статус

Текущее агрегированное состояние платформы

Проверяем…

Виджет читает несекретный same-origin health endpoint и показывает только ограниченную публичную сводку готовности.

Payment APIПроверяем…
Публичный UIПроверяем…
Merchant consoleПроверяем…
Реестр webhooksПроверяем…
СверкаПроверяем…
ФискализацияПроверяем…
03

Что показывает публичный health

GET /api/health возвращает ok, ready, service, version, mode, generatedAt и агрегированный объект readiness. Верхнеуровневый ready подходит для общего uptime/readiness check, а blockers и warnings помогают диагностировать состояние платформы.

Текст диагностических blockers не является стабильным API-контрактом. Автоматический мониторинг должен опираться на документированные поля и сохранять generatedAt, чтобы отличать свежий ответ от устаревшего результата.

04

Граница агрегированного статуса

ready=true означает, что общий runtime прошел текущие platform-level проверки. Это не доказывает наличие у конкретного merchant действующего договора, credentials, installation binding, callback, fiscal profile или разрешенного production provider route.

Merchant-specific readiness подтверждается отдельно в console/onboarding flow и тестовым платежом. Состояние внешнего банка или провайдера также нельзя выводить только из общего VPOS health.

05

Как использовать сигнал в эксплуатации

Мониторинг может опрашивать /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.