Documentación API

Threads de chat compatibles con OpenAI + SDK SDUI. Autentica con una clave SDK del cockpit.

Autenticación

Todos los endpoints públicos usan autenticación Bearer. Genera una clave en /sdk-keys del cockpit. Las claves tienen scopes:

Authorization: Bearer oag_xxxxxxxxxxxxxxxxxxxxxxxxx

Chat API scope: chat

Threads, mensajes, runs compatibles con 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

Widgets server-driven UI: incrusta listados CRM, dashboards, formularios en cualquier sitio.

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>

Errores y rate limits