ОБРАБОТКА ОШИБОК API-ИНТЕРФЕЙСА

Вызовы удалённых методов программного интерфейса СБИС (API) осуществляется на базе защищённого протокола HTTPS с передачей данных в формате JSON. При этом возможны ошибки на следующих уровнях:

  1. ошибки адресации сервера;
  2. ошибки HTTP/HTTPS протокола (транспортный уровень);
  3. ошибки в теле JSON-запроса;
  4. ошибки авторизации на online.sbis.ru (неверный логин/пароль, недопустимый сертификат ключа ЭП, отсутствие прав на доступ к методу);
  5. ошибки в параметрах функций внешнего интерфейса (например, отсутствие обязательного параметра);
  6. ошибки при выполнении команд (например, отсутствие запрашиваемого документа).

Анализ ответа на команду следует начинать с проверки HTTP кода ответа. Ответ, отличный от "HTTP/1.1 200 OK" означает ошибку и подлежит анализу.

Классы ошибок

Все ошибки делятся на два класса:

  • фатальные — ошибки, не допускающие исправления при повторном вызове без изменения параметров запроса или дополнительных действий;
  • нефатальные — ошибки, которые могут исправиться при повторном запросе спустя некоторое время без изменения параметров или дополнительных действий.

На заметку!

В программном интерфейсе СБИС (API) каждый класс ошибок имеет свой расширенный набор кодов.

Рекомендации при обработке ошибок:

  • при получении единичной нефатальной ошибки – сделать паузу на 3-5 секунд и повторить запрос.
  • при повторном получении ряда нефатальных ошибок на один и тот-же запрос в период дольше пяти минут приостановить запросы на 15 минут. При последующем повторении ошибок рекомендуем зайти в браузере на заглавную страницу online.sbis.ru и, при отсутствии профилактических или регламентных работ, трактовать ошибку как фатальную и обратиться в техническую поддержку.
0
0
Оставьте свой отзыв:
ОТПРАВИТЬ