Вирішення проблем

Типові проблеми при роботі з Rekognita API та їхні рішення.

401 Unauthorized

Причина: Невірний або відсутній API-ключ.

• Перевірте, чи ключ починається з rk_sk_, rk_rk_ або rk_test_
• Переконайтесь, що ключ не деактивовано в Dashboard
• Перевірте заголовок: Authorization: Bearer rk_sk_... (не API-Key)

429 Rate Limit

Причина: Занадто багато запитів.

• Реалізуйте exponential backoff
• Використовуйте заголовок Retry-After
• Розгляньте оновлення плану: Ліміти

Низька якість OCR

Рішення:

• Використовуйте модель rekognita-accurate замість rekognita-fast
• Переконайтесь, що документ має роздільну здатність ≥ 300 DPI
• Для скановних документів — перевірте контрастність та нахил
• Вкажіть language параметр для кращого розпізнавання

Таймаут обробки

Причина: Документ занадто великий або складний.

• Розбийте документ на частини (page_range параметр)
• Використовуйте rekognita-fast для великих обсягів
• Використовуйте вебхуки замість синхронних запитів

Таблиці не розпізнаються

• Використовуйте rekognita-accurate — ця модель найкраще працює з таблицями
• Переконайтесь, що таблиці мають чіткі границі
• Спробуйте графовий формат виходу: Графова структура

Вебхуки не приходять

• Перевірте, чи ваш сервер доступний з інтернету
• Переконайтесь, що ендпоінт повертає 200 OK
• Перевірте логи в Dashboard → Webhooks → Delivery Log
• Переконайтесь, що URL використовує HTTPS

Зв'язок з підтримкою

Якщо проблему не вдалося вирішити, зверніться до нас:

• Email: support@rekognita.com
• Включіть request_id з відповіді API для швидкого вирішення