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

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

Auth Chat API SDUI SDK Marketplace Developer Billing Multi-Agent Observability Webhooks

Авторизация

Все публичные эндпоинты используют 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>

Marketplace cockpit session

Browse public tools and hire pre-built AI worker templates.

GET/v1/internal/marketplace/tools

List public tools available for install. Returns pricing (O₮) and install status.

POST/v1/internal/marketplace/tools/{tool_id}/install
POST/v1/internal/marketplace/tools/{tool_id}/uninstall
GET/v1/internal/marketplace/templates

List active agent templates (pre-packaged AI workers).

POST/v1/internal/marketplace/templates/{id}/hire

One-click: creates a Sub-Agent pre-filled with template's prompt, tools, and cron schedule.

curl -X POST https://omra.pro/v1/internal/marketplace/templates/$TMPL_ID/hire \
  -H "Cookie: session=..."

Developer Console cockpit session

Manage your custom tools: set pricing, publish to the marketplace.

GET/v1/internal/developer/tools

List tools created by your company with current pricing and visibility.

PATCH/v1/internal/developer/tools/{tool_id}
{"is_public": true, "price_per_call": 5.0, "price_per_second": 0.1}

Billing & Ledger O₮ token economy

Top up with fiat (MercadoPago), check balance, track tool execution costs. 1 O₮ = $0.001 USD.

POST/v1/internal/billing/top-up
{"amount_usd": 10}  →  10,000 O₮ credited
GET/v1/internal/billing/balance
{"daily_quota": 50000, "spent_today": 12340.5, "remaining": 37659.5}

Multi-Agent System MAS

Sub-agents, approval gates, and execution observability.

POST/v1/internal/sub-agents

Create a cron-scheduled autonomous worker with prompt, tools, and budget limit.

GET/v1/internal/sub-agents
POST/v1/internal/sub-agents/{id}/run-now
GET/v1/internal/approvals/

List pending HITL approval requests from agents.

POST/v1/internal/approvals/{id}/resolve
{"status": "approved"}  →  agent resumes execution

Observability

Execution trace timelines — tool calls, latency, and O₮ cost per run.

GET/v1/internal/observability/trace/{run_id}
{"summary": {"total_cost": 12.5, "total_latency_ms": 4200, "tool_count": 3},
 "steps": [{"tool_name": "fetch_web_content", "latency_ms": 1800, "cost": 5.0, "status": "success"}, ...]}

Inbound Webhooks public

Wake up agents from external systems (CRM, Shopify, etc). No session required — authenticated by URL secret.

POST/v1/public/triggers/{company_id}/{webhook_secret}

Returns 202 Accepted immediately. Payload routed to Event Bus or a specific agent.

curl -X POST https://omra.pro/v1/public/triggers/$CID/$SECRET \
  -H "Content-Type: application/json" \
  -d '{"event_topic": "order.created", "payload": {"order_id": "ORD-42"}}'

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