Электронный документооборот

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

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

Команда «СБИС.Аутентифицировать» выполняет аутентификацию по логину и паролю, возвращает идентификатор сессии.

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

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

  • "Параметр": объект:
    • "Логин": строка
    • "Пароль": строка
    • "НомерАккаунта": строка

Результат

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

Комментарий

  • Если у пользователя есть доступ в разные кабинеты СБИС по одному логину/паролю, в запросе в поле «НомерАккаунта» укажите аккаунт, в который нужно войти.
  • Если номер аккаунта в запросе не указан, будет выполнен вход в тот кабинет, в котором пользователь авторизовался в предыдущий раз, в том числе через сайт.
  • Для пользователей с одним аккаунтом номер в запросе указывать не нужно.
  • Посмотреть номер аккаунта можно в личном кабинете или лицензионном договоре.

Пример запроса

{
   "jsonrpc": "2.0",
   "method": "СБИС.Аутентифицировать",
   "params": {
      "Параметр": {
         "Логин": "User",
         "Пароль": "Password"
      }
   },
   "id": 0
}
Скачать пример

Пример запроса с указанием аккаунта

{
   "jsonrpc": "2.0",
   "method": "СБИС.Аутентифицировать",
   "params": {
      "Параметр": {
         "Логин": "User",
         "Пароль": "Password",
         "НомерАккаунта": "12345"
      }
   },
   "id": 0
}
Скачать пример

Пример ответа (успех)

{
   "jsonrpc": "2.0",
   "result": "000b8ee4-000b8ee5-00ba-a40615cd1a61453a",
   "id": 0
}
Скачать пример

Пример ответа (ошибка)

{
   "jsonrpc": "2.0",
   "error": {
      "code": -32000,
      "message": "Проверьте правильность ввода логина и пароля!",
      "details": "Проверьте правильность ввода логина и пароля!",
      "data": {
         "classid": "{afd28339-dc44-4ad9-96dc-55a9789c743a}",
         "addinfo": null
      }
   },
   "id": 0
}
Скачать пример

Общая фатальная ошибка аутентификации

Код ответа 500, classid {00000000-0000-0000-0000-1FA000001000}. Ошибка означает, что сервис не может аутентифицировать пользователя. Текст ошибки описан в поле message. В этом случае внешнее приложение должно прекратить попытки аутентификации до устранения проблемы на стороне клиента.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "Проверьте правильность ввода логина и пароля!",
    "details": "Проверьте правильность ввода логина и пароля!",
    "data": {
      "classid": "{00000000-0000-0000-0000-1FA000001000}",
      "addinfo": null
    }
  },
  "id": 0
}
Скачать пример

Фатальная ошибка передачи входных параметров

Код ответа 500, classid {00000000-0000-0000-0000-1FA000001001}. Означает, что не переданы нужные параметры или часть обязательных параметров пустая.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "Ошибка аутентификации. Пустое значение поля Логин!",
    "details": "Ошибка аутентификации. Пустое значение поля Логин!",
    "data": {
      "classid": "{00000000-0000-0000-0000-1FA000001001}",
      "addinfo": null
    }
  },
  "id": 0
}
Скачать пример

Подтверждение аутентификации через смс

Код ответа 500, classid {00000000-0000-0000-0000-1FA000001002}.

В data.addinfo приходит информация для подтверждения входа:

  • телефон — замаскированный телефонный номер, на который будет отправлено смс-подтверждение,
  • идентификатор — временный индентификатор со сроком действия 5 минут, подтвердите его кодом из смс,
  • МетодОтправкиКодаПодтверждения — метод для отправки смс-подтверждения,
  • МетодПроверкиКодаИсключения — метод для подтверждения идентификатора кодом,
  • ИдентификаторСессии — временный идентификатор сессии.
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
        "message": "Требуется подтверждение действия",
        "details": "Требуется подтверждение действия",
        "data": {
      classid": "{00000000-0000-0000-0000-1FA000001002}",
         "addinfo": { 
           "Сообщение": "Для входа введите полученный код подтверждения.",
               "Телефон": "8(915)984-**-**",
               "Идентификатор": "dbef1dbb-1501-4f57-8783-0fc3f9c3b98d",
               "МетодОтправкиКодаПодтверждения": "СБИС.ОтправитьКодАутентификации",
               "МетодПроверкиКодаИсключения": "СБИС.ПодтвердитьВход",
               "ИдентификаторСессии": "00547bc6-0056d4a1-0bba-9a2cd69d2d804886"}
       }
  },
  "id": 0
}
Скачать пример

Фатальная ошибка «Слишком много вызовов»

Код ответа 429, classid {00000000-0000-0000-0000-1FA000000000}. Ошибка возникает, если система делает больше 300 вызовов в минуту.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "Предупреждение! Метод вызывается слишком часто и будет заблокирован на 600 секунд",
    "details": "Предупреждение! Метод вызывается слишком часто и будет заблокирован на 600 секунд",
    "data": {
      "classid": "{00000000-0000-0000-0000-1FA000001000}",
      "addinfo": null
    }
  },
  "id": 0
}
Скачать пример