Швидкий старт
Цей гайд допоможе вам розпочати роботу з 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/sdk3. Надішліть перший документ
Використовуйте наступний код для відправки документа на реструктуризацію:
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"
}Порада: Використовуйте вебхуки, щоб отримувати повідомлення автоматично, без поллінгу.