Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL не получает данные: контрольный список
Если отметки не поступают на ваш 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, данные шифруются. Ваш сервер должен расшифровывать их тем же ключом. Если вы не собирались использовать шифрование, удалите ключ.
- Не приостановлена ли доставка? Если ваш сервер ответил неожиданным образом, доставка пробуется до трёх раз и затем приостанавливается, с новой попыткой каждые три часа. Исправьте сервер и перезапустите очередь на странице 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?