Support Hub/API & Integrations/Коды статуса API: что означает каждая ошибка и как её исправить
Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Developer

Коды статуса API: что означает каждая ошибка и как её исправить

Каждый ответ RESTful API содержит числовой StatusCode. Код 0 означает успех. Ответы на callback отличаются: ваш сервер всегда отвечает {"status":"done"} с HTTP 200.

КодСтатусЧто означаетЧто делать
0SuccessОперация выполнена.Ничего.
1Invalid Request DataТело JSON повреждено или содержит недопустимые значения.Отправляйте чистый JSON в UTF-8 с заголовком Content-Type: application/json. Проверьте значения.
2Invalid Service Tag IDПараметр запроса stgid не соответствует ни одному зарегистрированному устройству.Заново скопируйте Service Tag ID из вашего аккаунта API Monitor.
3Invalid RequestЗапрос не соответствует формату этой операции.Сравните его с образцом запроса для этой операции.
4Invalid EncryptionНе удалось расшифровать данные AES-256.Проверьте ключ шифрования и кодировку Base64.
5Device OfflineЦелевое устройство сейчас не подключено к Cams.Проверьте страницу Device Status. Команда ставится в очередь и доставляется, когда устройство снова подключится.
6Operation TimeoutУстройство не подтвердило команду вовремя.Убедитесь, что устройство онлайн, и повторите.
7Invalid Auth TokenAuthToken не совпадает с заданным для устройства.Используйте 32-символьный токен из API Monitor.
8User Already ExistsВыполнена попытка добавить UserID, который уже есть на устройстве.Обновите пользователя или сначала удалите его.
9User Not FoundUserID нет на устройстве.Проверьте UserID. При необходимости сначала добавьте пользователя.
10Template ErrorБиометрический шаблон повреждён или имеет неподдерживаемый формат.Проверьте данные Base64, Size и Index шаблона.
11Device Memory FullУстройство достигло лимита пользователей или шаблонов.Удалите ненужных пользователей или шаблоны.
13Invalid Security KeyКлюч безопасности не совпадает с ключом в API Monitor.Используйте один и тот же ключ с обеих сторон.
15Feature Not SupportedЭта модель устройства или режим подключения не поддерживает операцию.Проверьте режим подключения. Режимы DB Pull и File Processing поддерживают только передачу посещаемости (push), но не команды RESTful.
999Unknown ErrorНепредвиденная ошибка.Свяжитесь с поддержкой Cams и укажите OperationID.

Советы

  • Генерируйте уникальный OperationID для каждого REST-запроса. Ответ повторяет его, так что вы сможете сопоставить запрос и ответ.
  • REST-командам требуется около 15 секунд, чтобы дойти до устройства.
  • Коды 12 и 14 не используются.

См. также: Callback URL not receiving data, Add or delete users in bulk.

Нужна помощь? Напишите на support@camsbiometrics.com и укажите OperationID и StatusCode.

Was this article helpful?