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 DataJSON-тіло має хибний формат або недійсні значення.Надсилайте чистий JSON у UTF-8 із заголовком Content-Type: application/json. Перевірте значення.
2Invalid Service Tag IDПараметр запиту stgid не відповідає жодному зареєстрованому пристрою.Знову скопіюйте Service Tag ID зі свого акаунта API Monitor.
3Invalid RequestЗапит не відповідає формату цієї операції.Порівняйте його із зразком запиту для цієї операції.
4Invalid EncryptionНе вдалося розшифрувати AES-256 payload.Перевірте ключ шифрування та кодування 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?