Команда «СБИС.Аутентифицировать» выполняет аутентификацию по логину и паролю, возвращает идентификатор сессии.
Адрес запроса: 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
}