Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL не отримує дані: контрольний список
Якщо punches не надходять на ваш callback URL, виконайте ці перевірки по черзі.
- Чи доходить пристрій до Cams? Відкрийте сторінку Device Status. Якщо пристрій офлайн, див. Why a device shows offline.
- Чи правильний URL? Перевірте callback URL, збережений у вашому акаунті API Monitor.
- Чи правильно відповідає ваш сервер? Завжди відповідайте
{"status":"done"}і HTTP-статусом 200, навіть якщо ваша власна обробка завершилася помилкою. Виконуйте важку роботу пізніше, у черзі, щоб Cams ніколи не чекав. - Чи доступна кінцева точка з інтернету? Для продакшну використовуйте порт 80 (HTTP) або 443 (HTTPS). Порт 8123 призначений лише для тестування. Дозвольте ці порти в брандмауері.
- Чи правильно налаштовано HTTPS? HTTPS із дійсним SSL-сертифікатом на порту 443 підтримується й рекомендований. Переконайтеся, що сертифікат поновлюється без перезапуску сервера.
- Чи читаєте ви тіло як чистий JSON? Запити — це чистий JSON у UTF-8, а не поля форми.
- Чи правильна перевірка AuthToken? Кожен callback містить AuthToken. Порівняйте його з токеном, заданим в API Monitor, і відхиляйте невідповідність. Переконайтеся, що ви не відхиляєте добрі запити через порівняння з хибним токеном.
- Чи ввімкнено шифрування? Якщо в API Monitor задано Security Key, payloads шифруються. Ваш сервер має розшифровувати їх тим самим ключем. Якщо ви не збиралися використовувати шифрування, видаліть ключ.
- Чи призупинилася доставка? Якщо ваш сервер відповів неочікувано, доставку пробують до трьох разів, а потім призупиняють і пробують знову кожні три години. Виправте сервер і перезапустіть чергу на сторінці Device Status. Див. Punches not transmitting or queuing up.
Перевірте
- Надішліть тестовий POST на ваш URL через Postman або cURL.
- Щоб перевірити зі свого комп'ютера, використовуйте тунель, наприклад ngrok. Див. Testing callback URLs from your local environment.
- Щоб створити приймач, див. Building a biometric callback receiver.
Події, які не вдалося доставити, зберігаються й надсилаються, щойно ваш сервер знову запрацює. Див. Punches made while a device was offline.
Залишилися питання? Напишіть на support@camsbiometrics.com, вказавши серійний номер пристрою та короткий опис проблеми.
Was this article helpful?