API для интеграций

Отправляйте аудио из своих сервисов и получайте транскрипт, сводку и готовые документы. Интерактивная схема: /api/swagger.

Авторизация

Создайте ключ в кабинете → Интеграции. Передавайте его в заголовке X-API-Key (или Authorization: Bearer …). Ключ показывается один раз; храните его как пароль.

Загрузить запись

POST/api/recordings — multipart: file (аудио/видео, любой формат), необязательно title и template (general · meeting · lecture · interview · sales · idea).

curl -X POST https://ваш-домен/api/recordings \
  -H "X-API-Key: el_..." \
  -F "file=@call.m4a" -F "template=sales"
# → {"id": 42, "status": "queued"}

Статус и результат

GET/api/recordings/{id} — поле status: queued → transcribing → summarizing → done | error. В готовой записи: transcript, segments (с таймкодами) и summary:

{
  "title": "...", "tldr": "...", "summary": "markdown",
  "key_points": ["..."], "topics": [{"title": "...", "points": ["..."]}],
  "decisions": ["..."], "action_items": [{"task": "...", "owner": "...", "due": "..."}],
  "questions": ["..."], "mindmap": {"title": "...", "children": [...]}
}

Экспорт

GET/api/recordings/{id}/export/{format}

format	Файл
`md`	Markdown со сводкой и транскриптом
`mindmap`	Интерактивная карта (HTML)
`mindmap-mm`	FreeMind .mm — XMind, Miro, MindManager
`mindmap-md`	Markdown-дерево (markmap)
`xlsx`	Excel: сводка, задачи, решения, транскрипт
`docx`	Word-протокол
`pptx`	Презентация
`txt`, `srt`	Транскрипт, субтитры

Другие методы

POST`/api/recordings/from-url`	Расшифровка по ссылке YouTube `{"url": "https://youtu.be/...", "template": "meeting"}`. Видео не скачивается: берутся субтитры, при их отсутствии распознаётся звук
GET`/api/recordings?q=текст`	Список и поиск
PATCH`/api/recordings/{id}`	Переименовать `{"title": "..."}`
POST`/api/recordings/{id}/resummarize`	Пересобрать сводку другим шаблоном
DELETE`/api/recordings/{id}`	Удалить запись и аудио

Вебхуки

Добавьте адрес в кабинете — после обработки каждой записи мы отправим POST с JSON {"event": "recording.completed", "recording": {…}}. Подпись — заголовок X-Replika-Signature: sha256=<hex>, это HMAC-SHA256 тела запроса с секретом вебхука (виден при создании).

# Python: проверка подписи
import hmac, hashlib
ok = hmac.compare_digest(
    "sha256=" + hmac.new(SECRET.encode(), request_body, hashlib.sha256).hexdigest(),
    request.headers["X-Replika-Signature"])

Подойдёт для Zapier, Make, n8n, Notion/Google Sheets через автоматизации и собственных обработчиков.