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

Rekognita API використовує Bearer-токени для авторизації запитів. Кожен запит до API повинен містити заголовок Authorization з вашим API-ключем.

Формат заголовка

Authorization: Bearer YOUR_API_KEY

Створення API-ключа

1. Увійдіть до дашборду Rekognita.
2. Перейдіть до Settings → API Keys.
3. Натисніть Create New Key.
4. Оберіть необхідні дозволи (scopes).
5. Скопіюйте ключ — він буде показаний лише один раз.

Scopes (дозволи)

При створенні ключа ви можете обрати один або декілька дозволів:

• documents:read — читання документів та результатів.
• documents:write — завантаження та видалення документів.
• webhooks:manage — управління вебхуками.
• account:read — інформація про акаунт та використання.

Приклади

curl

curl https://api.rekognita.com/v1/documents \
  -H "Authorization: Bearer rk_sk_abc123def456"

Python

import os
from rekognita import Client

client = Client(api_key=os.environ["REKOGNITA_API_KEY"])

Node.js

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

const client = new Rekognita({
  apiKey: process.env.REKOGNITA_API_KEY,
});

Обробка помилок

Якщо ключ недійсний або відсутній, API поверне відповідь з кодом 401 Unauthorized:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}