REST API DropCat: подписание документа
POST /signDocument
Метод предназначен для подписания ранее созданного документа. Общий запрос без дифференцирования по типам документов на платформе.
Формат запроса
Запрос на подписание документа следует отправлять с помощью метода POST.
/signDocument
?[id_type= <тип идентификатора>]
&[org_id= <идентификатор>]
&[doc_id= <идентификатор документа>]
Параметры запроса
| Параметр | Пример значения | Описание | Тип параметра | Тип данных |
|---|---|---|---|---|
| id_type* | gln |
Тип идентификатора организации. Принимает значения: gln или fns. |
query | string |
| org_id* | 2000000009994 | Идентификатор организации-инициатора запроса. | query | string |
| doc_id* | 116389021 | Идентификатор документа. | query | long |
* Обязательный параметр.
Используется общий запрос подписания для документов, статусных квитанций. Для подписания в запросе передается идентификатор документа, который подписывается. Если подписывается статусная квитанция, то в запросе передается идентификатор статуса. В теле запроса передается список подписей в формате json. Если документ подписывается несколькими подписями, то в списке подписей они передаются через запятую, порядок подписания неважен. Полученные подписи валидируются на платформе.
["MIIc6gYJKoZIhvcNAQcCoIIc2zCCHNcCAQExDDAKBgYqhQMCAgkFADALBgkqhkiG...","MIIc6gYJKoZIhvcNAQcCoIIc2zCCHNcCAQExDDAK..."]
Предварительно контент документа можно запросить, вызвав метод /getDocument
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 200.
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Curl запроса
curl -X POST --header "Content-Type: application/json" --header "Accept: application/json" -d "[\"MIAGCSqGSIb3DQEHAqCAMIACAQExDjAMBggqhQMHAQECAgUAMIAGCSqGSIb3DQEH
AaCAJIAEgwEAAP/Y/+AAEEpGSUYAAQIAAAEAAQAA/+EAsEV4aWYAAElJKgAIAAAA
...
ZxCwG1yGSTg8EIUjfVkuYMx7cZre7ENCNat0ogAAAAAAAA==
\"]" "https://dapi-preprod.ediweb.ru/edi/api/v1.1/signDocument?id_type=gln&org_id=2000000009994&doc_id=116389021"
URL запроса
https://dapi-preprod.ediweb.ru/edi/api/v1.1/signDocument?id_type=gln&org_id=2000000009994&doc_id=116389021
Тело ответа
Document '116389021' was signed, status = 'DRAFT'
HTTP код ответа
200
Заголовки ответа
{
"connection": "keep-alive",
"content-length": "49",
"content-type": "text/plain; charset=UTF-8",
"date": "Fri, 17 Jul 2020 09:11:37 GMT",
"doc_id": "116389021",
"request_uuid": "36ef101a-d997-47ad-8423-8bb3cc3a6b8f",
"server": "nginx"
}