ym88659208ym87991671
Создание запроса на выпуск сертификата ЕИО | Документация для разработчиков

Создание запроса на выпуск сертификата ЕИО

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

Alt text /fintech/api/v1/crypto/cert-requests/eio

Ресурс позволяет создавать запросы на выпуск нового сертификата для любого пользователя Сбербизнес компании. Работает с access_token пользователей с признаком единоличный исполнительный орган (ЕИО).

Для создания запроса на выпуск нового сертификата необходимо отправить POST-запрос /fintech/api/v1/crypto/cert-requests/eio с токеном доступа (access_token) пользователя-ЕИО в параметре Authorization заголовка и реквизитами запроса в теле.

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


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

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

Request

/fintech/api/v1/crypto/cert-requests/eio
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя, полученный через SSO.
BODY
CertRequest {
  emailstringstring^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+.[A-Za-z]{2,}$requiredАдрес электронной почты,
  externalIdstringUUID^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$requiredЛогин пользователя, для которого создается запрос на сертификат,
  loginstringstringrequiredИдентификатор документа, присвоенный партнером,
  numberstringstringrequiredНомер документа,
  orgNamestringstringoptionalКраткое наименование организации,
  pkcs10Pkcs10objectrequiredДанные запроса на сертификат ЭП,
  userNamestringstringrequiredФамилия, имя и отчество,
  userPositionstringstringrequiredДолжность
}
Pkcs10 {
  bicryptIdstringstringrequiredИдентификатор bicryptId,
  cmsstringstringrequiredДанные запроса на сертификат ЭП в формате CMS (PKCS #10)
}

Responses

201 (Created)
НаименованиеТипОбязательностьОписание
HEADER
AuthorizationstringrequiredAccess token пользователя, полученный через SSO.
BODY
CertRequest {
  bankCommentstringoptionalБанковский комментарий к статусу документа,
  bankStatusstringoptionalСтатус документа,
  emailstringrequiredАдрес электронной почты,
  externalIdstringrequiredИдентификатор документа, присвоенный партнером,
  loginstringrequiredЛогин пользователя, для которого создается запрос на сертификат,
  numberstringrequiredНомер документа,
  orgNamestringoptionalКраткое наименование организации,
  pkcs10Pkcs10requiredДанные запроса на сертификат ЭП,
  userNamestringrequiredФамилия, имя и отчество,
  userPositionstringrequiredДолжность
}
Pkcs10 {
  bicryptIdstringrequiredИдентификатор bicryptId,
  cmsstringrequiredДанные запроса на сертификат ЭП в формате CMS (PKCS #10)
}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запросаДанные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request метода. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTНе удалось определить единственный криптопрофиль с типом: ИнфокриптПрофиль пользователя, чей login используется в request, имеет тип защиты "SMS".

Запрос на выпуск сертификата можно отправлять на профили с типом защиты "электронный ключ (токен)".
Внешний идентификатор {externalId} не может быть использован для создания документаНеобходимо перегенировать externalId и отправить запрос повторно
Уже существует ключ проверки с идентификатором {bicryptId}, имеющий либо сертификат, либо запрос с одним из активных статусовНеобходимо сформировать новое значение bicryptId по указанной в спецификации формуле: certCenterCode + (certCenterNum +1) + s + ФамилияИО
НаименованиеТипОбязательностьОписание
Notice {
  causestringoptionalПричина или основание сообщения,
  referenceIdstringoptionalУникальный идентификатор,
  messagestringoptionalСообщение
}
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, не указана операция CRYPTO_CERT_REQUEST_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 в настройках своего браузера.