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