docs
UAEN
Docs/Швидкий старт

Швидкий старт

Цей гайд допоможе вам розпочати роботу з Rekognita API за декілька хвилин. Ви отримаєте API-ключ, відправите перший документ та отримаєте повністю структурований результат.

1. Отримайте API-ключ

Зареєструйтесь на rekognita.com та перейдіть до розділу Dashboard → API Keys. Натисніть Create Key, щоб згенерувати новий ключ.

Зберігайте ключ у безпеці. Не передавайте його у публічні репозиторії та не вбудовуйте у клієнтський код.

2. Встановіть SDK (опціонально)

Ви можете працювати напряму з REST API через curl або HTTP-клієнт, або встановити офіційний SDK:

# Python
pip install rekognita

# Node.js
npm install @rekognita/sdk

3. Надішліть перший документ

Використовуйте наступний код для відправки документа на реструктуризацію:

Python

from rekognita import Client

client = Client(api_key="YOUR_API_KEY")

result = client.documents.create(
    file=open("invoice.pdf", "rb"),
    language="uk"
)

print(f"Document ID: {result.id}")
print(f"Status: {result.status}")

Node.js

import { Rekognita } from '@rekognita/sdk';

const client = new Rekognita({ apiKey: 'YOUR_API_KEY' });

const result = await client.documents.create({
  file: fs.createReadStream('invoice.pdf'),
  language: 'uk',
});

console.log('Document ID:', result.id);
console.log('Status:', result.status);

4. Отримайте структурований результат

Після завершення обробки ви отримаєте повністю реструктуризований документ:

GET /v1/documents/doc_abc123/result
Authorization: Bearer YOUR_API_KEY
{
  "id": "doc_abc123",
  "status": "completed",
  "document_type": "invoice",
  "result": {
    "header": { "company": "ТОВ «Приклад»", "number": "№1234" },
    "line_items": [
      { "name": "Послуга", "quantity": 1, "total": 15000.00 }
    ],
    "totals": { "subtotal": 15000.00, "vat": 3000.00, "total": 18000.00 }
  },
  "confidence": 0.991,
  "language": "uk"
}
Порада: Використовуйте вебхуки, щоб отримувати повідомлення автоматично, без поллінгу.

Наступні кроки