Электронная подпись¶

Общие правила чтения полей, причины отказа и форматы файлов full/light описаны в обзоре.

Идентификация для электронной подписи¶

Родитель: ds_identifier_result. Идентификация подписанта для ЭП; состав данных зависит от варианта идентификации.

Поля ds_identifier_result.

Поля с пометкой «Обязателен» присутствуют всегда внутри этого объекта. Остальные поля — при наличии значения; null исключается из ответа.

Поле	Тип в JSON	Назначение и условия
`phone`	string	Телефон подписанта.
`iin`	string	ИИН подписанта, до 12 символов.
`bin`	string	БИН организации-подписанта, до 12 символов; для физического лица может отсутствовать.
`company_title`	string	Название организации-подписанта, если применимо.
`is_subject_in_mcdb`	boolean	Наличие пользователя в Базе мобильных граждан, если проверялось.
`edocument_response`	JSON	Сохранённый ответ электронного документа для идентификации. Динамическая структура; light не преобразует её содержимое.
`result`	boolean	Сохранённый результат технологии: `true` — принята, `false` — отрицательный результат. До расчёта может отсутствовать; учитывайте статус и особенности ниже.
`failure_reason`	object	Причина отказа, если записана; структура.

Промежуточные статусы выпуска сертификата и идентификаторы пользователя удостоверяющего центра этот блок не возвращает.

Подписание электронной подписью¶

Родитель: ds_signer_result. Итог подписания документов.

Поля ds_signer_result.

Поля с пометкой «Обязателен» присутствуют всегда внутри этого объекта. Остальные поля — при наличии значения; null исключается из ответа.

Поле	Тип в JSON	Назначение и условия
`document_type`	string, enum	Обязателен: `PDF` — PDF-документ, `XML` — XML-документ.
`check_id`	string	Идентификатор чека / проверки подписания при наличии; используется при формировании подписанных документов. Не `session_id`; отдельный строковый идентификатор.
`result`	boolean	Сохранённый результат технологии: `true` — принята, `false` — отрицательный результат. До расчёта может отсутствовать; учитывайте статус и особенности ниже.
`failure_reason`	object	Причина отказа, если записана; структура.

Список подписанных файлов, их Base64 и URL этим блоком не возвращаются. status процесса подписания также отсутствует и в полном, и в light-ответе.

JSON-примеры¶

Фрагменты корневого объекта ответа, а не целостные ответы. Все значения и ссылки условные. Формат файлов соответствует пояснениям на этой странице.

{
  "ds_identifier_result": {
    "result": true,
    "iin": "000000000000"
  },
  "ds_signer_result": {
    "document_type": "PDF",
    "result": true,
    "check_id": "66666666-6666-4666-8666-666666666666"
  }
}