docs
UAEN
Docs/Огляд API

Огляд API

Rekognita API — це REST API для обробки документів. Базова URL-адреса для всіх запитів:

https://api.rekognita.com

Аутентифікація

Усі запити потребують API-ключ в заголовку Authorization:

Authorization: Bearer rk_sk_your_key_here

Детальніше: Авторизація API

Формат запитів

API приймає запити у форматі multipart/form-data для завантаження файлів та application/json для інших операцій.

POST /v1/documents/convert HTTP/1.1
Host: api.rekognita.com
Authorization: Bearer rk_sk_your_key
Content-Type: multipart/form-data

file=@document.pdf
output_format=markdown

Формат відповідей

Усі відповіді повертаються у JSON:

{
  "id": "doc_abc123",
  "status": "completed",
  "pages": 5,
  "content": "# Document Title\n\nContent...",
  "metadata": {
    "format": "markdown",
    "processing_time_ms": 1240,
    "model": "rekognita-accurate"
  }
}

Моделі обробки

Rekognita пропонує три моделі обробки:

МодельШвидкістьЯкістьВикористання
rekognita-fast~0.8с/сторВисокаВеликі обсяги, реальний час
rekognita-balanced~1.5с/сторДуже високаРекомендований за замовчуванням
rekognita-accurate~3с/сторНайвищаКритичні документи, фінанси

Формати виходу

Rekognita підтримує кілька форматів виходу — від простого тексту до графової структури документа:

  • Графова структура — повна структура документа з елементами та зв'язками
  • Word/PDF — реструктуровані документи у Word або PDF форматі
  • Markdown & HTML — чисті текстові формати зі збереженою структурою
  • JSON Schema — витягування даних за вашою JSON-схемою

Версіонування

API використовує версіонування через URL: /v1/. При введенні змін, що ламають зворотну сумісність, буде створено нову версію (/v2/). Старі версії підтримуються мінімум 12 місяців.

Далі