Документация API

OpenAI-совместимые треды и SDK для SDUI. Авторизация по SDK-ключу из панели управления.

Авторизация

Все публичные эндпоинты используют Bearer-авторизацию. Создайте ключ в разделе /sdk-keys панели управления. У ключей есть области доступа:

Authorization: Bearer oag_xxxxxxxxxxxxxxxxxxxxxxxxx

Chat API scope: chat

Треды, сообщения и запуски в формате OpenAI Assistants.

POST/v1/threads
curl -X POST https://omra.pro/v1/threads \
  -H "Authorization: Bearer $OAG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"metadata": {"user": "alice"}}'
GET/v1/threads/{thread_id}
POST/v1/threads/{thread_id}/messages
curl -X POST https://omra.pro/v1/threads/$TID/messages \
  -H "Authorization: Bearer $OAG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role": "user", "content": "Hello"}'
GET/v1/threads/{thread_id}/messages?limit=20&after=…
POST/v1/threads/{thread_id}/runs
curl -X POST https://omra.pro/v1/threads/$TID/runs \
  -H "Authorization: Bearer $OAG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "stream": false}'

SDUI SDK

Server-Driven UI: встраивайте списки из CRM, дашборды и формы на любой сайт.

POST/v1/sdk/token
GET/v1/sdk/view/{service}/{view_name}scope: view
POST/v1/sdk/actionscope: action
Web Component
<script type="module" src="https://omra.pro/v1/sdk/sdui-embed.js"></script>

<cockpit-widget
  gateway="https://omra.pro"
  service="bitrix24"
  view="deals_list"
  auth-token="oag_xxxxxxxxxxxxx">
</cockpit-widget>

Ошибки и ограничения