Public API

AI-задача из вашей системы за один запрос

Scoped API keys, REST для задач/runs/approvals/Playbooks и подписанные webhooks с retry, delivery log и replay.

AUTH

Bearer API key

Ключ показывается один раз. В БД хранится только SHA-256 hash. Scopes ограничивают задачи, approvals, knowledge и Playbooks.

Authorization: Bearer dk_live_...
X-API-Key: dk_live_...  # альтернатива

WEBHOOKS

HMAC + event id

Каждая доставка содержит event id и timestamp-подпись. Получатель должен проверять подпись и дедуплицировать по event id.

Delora-Event-Id: <uuid>
Delora-Event-Type: task.completed
Delora-Signature: t=1700000000,v1=<hmac>

Быстрый старт

# 1. Создать API key в Settings → API и webhooks
export DELORA_KEY="dk_live_..."

# 2. Создать задачу идемпотентно
curl -X POST https://office.ruvv.su/v1/public/tasks \
  -H "Authorization: Bearer $DELORA_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-lead-42" \
  -d '{"title":"Квалифицировать лид","brief":"CRM lead 42"}'

Песочница создаётся отдельным sandbox-ключом и живёт в изолированной компании без production-данных.

Endpoints

POST /v1/public/tasksscope: tasks:write

GET /v1/public/tasksscope: tasks:read

GET /v1/public/tasks/{id}scope: tasks:read

GET /v1/public/runs/{id}scope: runs:read

GET /v1/public/approvals/{id}scope: approvals:read

POST /v1/public/approvals/{id}scope: approvals:write

POST /v1/public/knowledgescope: knowledge:write

GET/POST /v1/public/playbooks/{id}scope: playbooks:read/write