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: https://timevisit.ru/auth/realms/std/protocol/openid-connect/token (grant_type=client_credentials). Требуемые scopes: notification (отправка нотификаций), webhook (управление webhook).
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |