Перейти к основному содержимому

ExtendedSignerDetails (POST) (V2)

Заполняет дополнительные данные подписанта.

Дополнительные данные подписанта могут быть заполнены:

  • Автоматически — для документов, перечисленных в поле ExtendedDocumentTitleType структуры SignerInfoV2, Диадок заполнит данные подписанта на основе информации из сертификата и реквизитов организации, если были указаны BoxId и Certificate/CertificateThumbprint. Если в Диадоке нет дополнительных данных, необходимых для подписания, то возникнет ошибка.
  • Вручную — с помощью метода ExtendedSignerDetails.

POST /V2/ExtendedSignerDetails

Параметры запроса

  • boxId — идентификатор ящика организации, для которого нужно заполнить дополнительные данные подписанта, в формате GUID.
  • thumbprint — отпечаток сертификата, для которого нужно заполнить дополнительные данные подписанта.
  • documentTitleType — тип титула, для которого нужно заполнить дополнительные данные подписанта. Принимает значения из перечисления DocumentTitleType.

Заголовки запроса

Тело запроса

Тело запроса должно содержать информацию для заполнения дополнительных данных подписанта, представленную структурой ExtendedSignerDetailsToPost.

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора и у пользователя нет доступа к указанному сертификату.
  • 405 — используется неподходящий HTTP-метод.
  • 415 — тип содержимого запроса не поддерживается.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит данные подписанта, представленные структурой ExtendedSignerDetails.

Примеры использования

Пример HTTP-запроса:

POST /V2/ExtendedSignerDetails?boxId={{boxId}}&thumbprint=ee67...fa1e1&documentTitleType=UtdSeller HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json

Пример тела запроса:

{
"JobTitle": "Сотрудник",
"SignerType": "PhysicalPerson",
"SignerInfo": "Additional",
"SignerPowers": "PersonMadeOperation",
"SignerStatus": "SellerEmployee"
}

Пример тела ответа:

{
"Surname": "Иванов",
"FirstName": "Иван",
"Patronymic": "Иванович",
"JobTitle": "Сотрудник",
"Inn": "930745467108",
"SignerType": "PhysicalPerson",
"SignerInfo": "Additional",
"SignerPowers": "PersonMadeOperation",
"SignerStatus": "SellerEmployee"
}

См. также

Инструкции:

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года