Перейти до основного вмісту
При зверненні клієнта до сервісу CheckLists по API, можуть виникати ситуації коли сервіс чи пошукові реєстри, які використовує сервіс, недоступні. Для коректного опрацювання даних ситуацій необхідно знати наступне. У відповідь на запит сервіс повертає HTTP-статус відповіді. Аналізуючи його та структуру відповіді, можна виділити наступні ситуації в роботі сервісу:
  • HTTP-статус з кодом в діапазоні 500-599 - сервіс CheckLists недоступний, або працює некоректно
  • HTTP-статус з кодом в діапазоні 400-499 - сервіс CheckLists доступний, проте не може опрацювати ваш запит. У відповіді замість описаної вище структури, клієнт отримає наступну структуру з описом помилки:
    • error int
    • message string
Перелік помилок:
messageerror
Користувач «користувач» відсутній.ACCOUNT_NOTFOUND = 1;
Адреса «ip адреса» відсутня у списку дозволених.NOT_ALLOW_IP = 2;
Тестовий (акційний) доступ: ліміт запитів вичерпано або термін дії закінчився.TEST_ACCESS_END = 3;
Користувачу «користувач» дозволений доступ тільки через веб ресурс.SITEONLY = 6;
Дата початку користування сервісом «дата початку» ще не настала.ACCOUNT_NOT_ALLOWED_YET = 7;
«дата закінчення» закінчився дозволений період користування сервісом.ACCOUNT_ACCESS_ENDS = 8;
Користувач «користувач» заблокований.ACCOUNT_BLOCKED = 9;
Користувач «користувач» не підтвердив реєстрацію.ACCOUNT_NOT_CONFIRM = 10;
Ліміт запитів («ліміт запитів») було вичерпано.ACCOUNT_REQUEST_LIMIT_ENDS = 11;
Не вірно вказаний параметр ‘Початкова дата’ для перевірки змін в ЄДРЮО і ФОПREQUEST_BEGINDATE_ERROR = 103;
Не вірно вказаний параметр ‘Кінцева дата’ для перевірки змін в ЄДРЮО і ФОПREQUEST_ENDDATE_ERROR = 104;
Не вірно вказаний параметр нижньої межі входження lowranklimit для пошуку по базі санкційних списків.REQUEST_LOWRANKLIMIT_ERROR = 105;
  • HTTP-статусом з кодом 200 - сервіс CheckLists доступний і може опрацьовувати запити від клієнтів. Структура відповіді може змінюватися в залежності від доступу до пошукових реєстрів.
    • пошуковий реєстр до яких ви звертаєтесь працює, ви маєте до нього доступ, та опрацювання запиту не перевищує виділений для цього час - сервіс завжди повертає результат (структура описана вище по тексту, або порожній масив у разі відсутності збігів)
    • iнакше в блоці відповіді по даному пошуковому реєстру замість структури відповіді клієнт може отримати текстове повідомлення з помилкою. Перелік даних повідомлень та ситуацій при яких вони з’являються:
      • “9000.Відсутній зв’язок з сервісом” – Пошуковий реєстр не працює або сервіс немає зв’язку з ним
      • “9001.Доступ до сервісу заборонений” - Доступ до пошукового реєстру заборонений, так як він не входить в пакет послуг, які ви оплатили
      • “9003.Обробка запиту перевищує виділений для цього час. Уточніть запит” – виникає коли обробка запиту до пошукового реєстру перевищує виділений для цього час
      • “9004.Відсутній зв’язок з базою даних сервісу” - виникає коли сервіс, який обслуговує реєстр, доступний, проте відсутній зв’язок з базою даних реєстру