unotice-openapi-client - HTTP API
REST API для отправки нотификаций через platform-notification-service. Авторизация через OAuth2 JWT (Keycloak). Клиент идентифицируется по claim client_id из токена. Webhook привязан к клиенту из токена (один клиент = один webhook URL).
Rate-limit: 100 запросов в минуту на интеграцию (по client_id из JWT). При превышении — 429.
Webhook callback: после того как нотификация достигнет терминального статуса, сервис отправляет POST-запрос на URL, зарегистрированный через POST /api/v1/webhooks. Формат payload-а и retry-политика описаны в секции callbacks этого endpoint-а (схема NotificationCallbackEvent).
Authentication
- HTTP: Bearer Auth
OAuth2 JWT токен из Keycloak. Требуемые scopes проверяются на стороне сервиса: SCOPE_notification (отправка нотификаций), SCOPE_webhook (управление webhook).
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |