ExtendedSignerDetails (POST) (V2)
Заполняет дополнительные данные подписанта.
Дополнительные данные подписанта могут быть заполнены:
- Автоматически — для документов, перечисленных в поле
ExtendedDocumentTitleTypeструктуры SignerInfoV2, Диадок заполнит данные подписанта на основе информации из сертификата и реквизитов организации, если были указаныBoxIdиCertificate/CertificateThumbprint. Если в Диадоке нет дополнительных данных, необходимых для подписания, то возникнет ошибка. - Вручную — с помощью метода
ExtendedSignerDetails.
POST /V2/ExtendedSignerDetails
Параметры запроса
boxId— идентификатор ящика организации, для которого нужно заполнить дополнительные данные подписанта, в формате GUID.thumbprint— отпечаток сертификата, для которого нужно заполнить дополнительные данные подписанта.documentTitleType— тип титула, для которого нужно заполнить дополнительные данные подписанта. Принимает значения из перечисления DocumentTitleType.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать информацию для заполнения дополнительных данных подписанта, представленную структурой 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"
}
См. также
Инструкции: