Подписание документов

На изображении представлен алгоритм процесса подписания документов, выпущенными через API выпуска сертификатами.

Процесс подписания документов.

Создание запроса на подпись

Чтобы инициализировать подписание документов, необходимо загрузить документы, которые будут отправлены на подписание, методом POST /contents. После необходимо создать операцию подписи методом POST /signatures. В запросе указывается список идентификаторов загруженных ранее контентов и идентификатор сертификата, которым необходимо совершить подписание.

Подтверждение подписания

После создания операции, владельцу сертификата отправится запрос на подпись в мобильное приложение Контур.Подпись. Когда владелец сертификата получит запрос, статус операции подписи изменится на AwaitingConformation. В приложении владелец сертификата должен подтверить или отклонить подписание:

  • Если владелец подтвердил подписание, то на сервере инициализируется процесс подписания
  • Если отклонил, то операция переходит в состояние Canceled.

Подтверждения подписи система ждет в течение 5 минут. Если владелец не успеет подтвердить подписание в течении этого времени, то операция перейдет в статус TimeOut.

Получение результатов подписания

Актуальный статус подписания можно получить методом GET /signatures/{signatureId}. Если подписание завершено успешно, то операция переходит в состояние Completed в описании каждого файла находится описание бинарных данных подписи. Подписи можно скачать методом GET /contents.