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 payload. | Перевірте ключ шифрування та кодування 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?