ym88659208ym87991671
Получение криптоинформации для ЕИО (КУЦ, пользователи и т.д.) | Документация для разработчиков

Получение криптоинформации для ЕИО (КУЦ, пользователи и т.д.)

Обновлено 29 ноября 2024

Alt text /fintech/api/v1/crypto/eio

Ресурс позволяет получить информацию по крипто-профилям и сертификатам всех пользователей, сертификатам удостоверяющих центров, и сертификату технологического криптопрофиля банка. Полученную информацию возможно использовать в криптографических операциях (в операциях с сертификатами и операциях с электронной подписью). Работает с access_token пользователей с признаком единоличный исполнительный орган (ЕИО).

Отправьте GET-запрос /fintech/api/v1/crypto/eio с токеном доступа (access_token) пользователя-ЕИО в параметре Authorization заголовка.

В параметре scope ссылки авторизации пользователя-ЕИО должен быть указан сервис GET_CRYPTO_INFO_EIO для получения доступа к этому ресурсу.


Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443
  • Промышленный контур https://fintech.sberbank.ru:9443

Request

/fintech/api/v1/crypto/eio
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя, полученный через SSO.

Responses

200 (OK)
НаименованиеТипОбязательностьОписание
CryptoInfo {
  certCenterCodestringoptionalКод удостоверяющего центра (КУЦ),
  certCenterNumstringoptionalТекущий порядковый номер для генерации сертификата,
  certsCAArray[string]optionalСертификаты удостоверяющих центров.

Возвращаются в формате base64. Для дальнейшего использования потребуется их раскодировать,
  cryptoUserInfosArray[CryptoUserInfo]optionalИнформация о пользователях
}
CryptoUserInfo {
  substringoptionalХэш идентификатора пользователя,
  cryptoProfileInfosArray[CryptoProfileInfo]optionalИдентификаторы криптопрофилей
}
CryptoProfileInfo {
  aliasstringoptionalПсевдоним,
  certificateInfosArray[CertificateInfo]optionalИнформация о сертификатах,
  typeNamestringoptionalНаименование типа
}
CertificateInfo {
  activebooleanoptionalПризнак активности,
  certstringoptionalСертификат.

Возвращается в формате base64. Для дальнейшего использования потребуеются его раскодировать,
  issuerstringoptionalИздатель,
  serialNumberstringoptionalСерийный номер,
  uuidstringoptionalУникальный идентификатор
}
401 (Unauthorized Error)
CauseMessageDescription
UNAUTHORIZEDaccessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.
НаименованиеТипОбязательностьОписание
Notice {
  causestringoptionalПричина или основание сообщения,
  referenceIdstringoptionalУникальный идентификатор,
  messagestringoptionalСообщение
}
403 (Forbidden)
CauseMessageDescription
ACTION_ACCESS_EXCEPTIONОперация не может быть выполнена: доступ к ресурсу запрещенИспользуемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API.

В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция GET_CRYPTO_INFO_EIO. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.
НаименованиеТипОбязательностьОписание
Notice {
  causestringoptionalПричина или основание сообщения,
  referenceIdstringoptionalУникальный идентификатор,
  messagestringoptionalСообщение
}
429 (Too Many Requests)
CauseMessageDescription
TOO_MANY_REQUESTSПревышен лимит запросов. Повторите операцию позже.Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее
НаименованиеТипОбязательностьОписание
Notice{
causestringoptionalПричина или основание сообщения,
referenceIdstringoptionalУникальный идентификатор ошибки (UUID),
messagestringoptionalСообщение,
}
500 (Internal Server Error)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
  causestringoptionalПричина или основание сообщения,
  referenceIdstringoptionalУникальный идентификатор,
  messagestringoptionalСообщение
}

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.