SLA и доступность

Доступность API

Целевой показатель доступности 99,5 % в месяц для партнёрского контура /v1/*. Это соответствует допустимому простою около 3 часов 39 минут в месяц (плановые окна обслуживания — см. ниже — в этот бюджет не засчитываются, если они анонсированы заранее).

Публичные проверки состояния сервиса:

Эндпоинт	Что проверяет	Ответ
`GET /health/live`	процесс жив	`200 {"status":"ok"}`
`GET /health/ready`	PostgreSQL доступен	`200 {"status":"ready"}` / `503 {"status":"unavailable"}`

Оба эндпоинта не требуют подписи запроса.

<уточняется>: GET /v1/status с детализацией по свежести синхронизации с iiko — из docs/PARTNER_API_V2_SPEC.md §7, планируется, недоступен в v1.

Свежесть данных при синхронизации с iiko (планируется, v2)

Эти показатели относятся к будущему каталогу/зонам/статусу точки (docs/PARTNER_API_V2_SPEC.md §0) и пока не применимы — в живом v1 нет собственного каталога, синхронизируемого из iiko:

Данные	Целевая свежесть	Статус
Стоп-лист	≤ 60 c	планируется
Меню и цены	≤ 10 мин	планируется
Типы оплаты и зоны доставки	≤ 1 ч	планируется
`is_alive` точки	≤ 60 c	планируется

Плановые окна обслуживания

Плановое обслуживание анонсируется не менее чем за 48 часов до начала. Канал анонса: <уточняется> (в v1 нет отдельной статус-страницы или email-рассылки для партнёров — способ анонса будет зафиксирован здесь до первого планового окна).

Время реакции поддержки

Приоритет	Время реакции	Время реакции — пример
Критично (заказы не создаются / не отменяются)	`<уточняется>`	—
Высокий (деградация — например задержка вебхуков)	`<уточняется>`	—
Обычный (вопрос по интеграции)	`<уточняется>`	—

Контакты и канал эскалации — см. Поддержку.

Что не покрывает этот SLA

Доступность ресторана/кассы и самого плагина iikoFront — это не часть AploDelivery API; если плагин на точке не поднят, заказы остаются в claimed/prepared до восстановления кассы (см. Жизненный цикл заказа).
Ограничения частоты запросов на уровне приложения. В коде v1 (internal/httpapi, internal/auth) нет отдельного middleware для rate-limiting партнёрского API — на уровне приложения ограничения нет вообще. Есть ли и какое значение имеет ограничение на сетевом уровне (nginx/файрвол перед сервисом) — <уточняется>, не проверялось по конфигурации хоста. Раздельные лимиты на credential (600 req/min) и на телефон гостя (30 req/min) — из docs/PARTNER_API_V2_SPEC.md §7, планируются.