СБИС.Аутентифицировать
Присоединяйтесь!
  1. Saby
  2. База знаний
  3. Электронный документооборот
  4. API ЭДО
  5. Справочник команд
  6. Аутентификация
  7. СБИС.Аутентифицировать

СБИС.Аутентифицировать

Команда выполняет аутентификацию по логину и паролю, возвращает идентификатор сессии.

Ограничения

  • Метод «СБИС.Аутентифицировать» допускает не более 300 вызовов в минуту. Не вызывайте его перед каждым обращением к API. Достаточно получить идентификатор сессии один раз, а затем кэшировать его в своей интеграции — например, в базе данных.
  • по умолчанию срок действия сессии составляет 21 день. Его можно изменить в настройках безопасности аккаунта.
  • повторно получайте сессию только при получении HTTP-ошибки 401 от Saby или меняйте идентификатор сессии раз в сутки.

Параметры запроса

В заголовке запроса укажите тип и кодировку: «content-type: application/json», «charset=UTF-8».

Адрес запроса: https://online.sbis.ru/auth/service/

  • "Параметр": объект:
    • "Логин": строка
    • "Пароль": строка
    • "НомерАккаунта": строка. Указывается, если у пользователя есть доступ в разные кабинеты Saby по одному логину и паролю. Если номер не указан, будет выполнен вход в кабинет, где пользователь авторизовался последний раз.

Результат

Строка — идентификатор сессии.

Примеры

Запрос без заполнения номера аккаунта

Ответ с ошибкой аутентификации — неверный логин или пароль

Ответ с фатальной ошибкой передачи входных параметров

Ответ при ошибке подтверждения аутентификации через смс

Ответ с фатальной ошибкой «Слишком много вызовов»

Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.
Продолжая пользоваться сайтом, вы даете согласие на обработку персональных данных. Если вы не согласны, покиньте сайт.