Отдельная документация realtime-контура CORP - HiRo. HTTP API продолжает жить в OpenAPI, а WebSocket-контур документируется отдельно через AsyncAPI, без смешивания двух протоколов в одной схеме.
{{ ws_endpoint_url }}
Browser получает одноразовый билет через
POST /api/auth/ws-ticket/ и подключается с
?ticket=<one_time_ticket>. Non-browser
client может использовать заголовок
Authorization: Bearer <jwt_access_token>.
В схеме отражены клиентские action-сообщения и серверные realtime-события для чатов, уведомлений, typing, реакций, read-sync и procurement updates.
Swagger и ReDoc используют OpenAPI-схему HTTP API. Для WebSocket-протокола отдельный AsyncAPI-документ чище, понятнее и лучше масштабируется.
{{ schema_text }}