Аутентификация

Все запросы к Chat Center API требуют валидного Bearer-токена в заголовке Authorization.

Получение токена

Перейдите в std.seven.tech/ui/integrations/ и создайте интеграцию типа HTTP API. После создания client_id и client_secret будут отправлены на вашу электронную почту.

Получите JWT-токен через Keycloak:

curl -X POST https://std.seven.tech/auth/realms/std/protocol/openid-connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<ваш-client_id>" \
  -d "client_secret=<ваш-client_secret>"

В ответе будет поле access_token — это и есть Bearer-токен для запросов к API.

Использование токена

Передавайте токен в каждом запросе:

Authorization: Bearer <ваш-токен>

Пример запроса

curl -X POST https://std.seven.tech/unotice-openapi-client/api/v1/notifications \
  -H "Authorization: Bearer <ваш-токен>" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": { "value": "79001234567" },
    "notificationText": "Текст уведомления",
    "externalId": "my-unique-id-001"
  }'

Scopes

Scope	Назначение
SCOPE_notification	Отправка уведомлений
SCOPE_webhook	Управление webhook

Идемпотентность

При повторном запросе с тем же externalId в рамках одного клиента API вернёт тот же notificationId без повторной отправки. Поле externalId рекомендуется указывать всегда — это позволяет безопасно ретраить запросы при получении ответов 500/503.