Запрос служит для контроля состояния процесса асинхронной модификации ЭП. Если процесс находится в стадии выполнения будет возвращен HTTP статус код 202, в случае успешного завершения - 200 с дополнительными данными об процессе модификации ЭП. В остальных случаях возвращаются соответствующие коды из серий 4хх и 5хх.
URL-адрес запроса
https://localhost:9092local.cipher.kiev.ua:9090/api/v1/ticket/{uuid}/ds/modifier
Метод
GET
Параметры запроса
| uuid | String | Идентификатор сессии |
Настраиваемые заголовки запроса
Отсутствует
Ответ
| Код ответа | Content-type | Допустимые параметры | Пример содержимого |
|---|---|---|---|
| 200 | application/json | message modifyResults | { |
| 202 | application/json | message | { |
| 503 | application/json | message | { |
| 400 | application/json | message | { |
| 406 | application/json | message modifyResults failureCause | { |
Параметры JSON объекта ответа
| Параметр | Тип данных | Описание |
|---|---|---|
| message | String | Описание результата проведения операции |
| failureCause | String | Описание причины возникновения ошибки, которая возникла при выполнении запроса на модификацию ЭП |
| modifyResults | Array | Результаты модификации отдельно по каждой из ЭП |
...
| Поле | Тип данных | Описание |
|---|---|---|
| 12615756 | Object* | Персональные данные |
| alternativeOwnerName | Object* | Альтернативное имя владельца |
| subjectKeyId | Object* | Идентификатор ключа |
| issuerKeyId | Object* | Идентификатор ключа издателя |
| subjectOwnerId | Object* | Идентификатор владельца |
| certificateProfile | Object* | Профиль сертификата |
| keyUsage | Object* | Назначение сертификата |
| isTemporary | Object* | Признак стартового сертификата |
| isReinforced | Object* | Признак усиленного сертификата |
...
| Code Block |
|---|
{
"message": "Електронний підпис успішно модифікований.",
"modifyResults": [
{
"status": "SUCCESS",
"previousSignatureFormat": "CADES_BES",
"currentSignatureFormat": "CADES_X_LONG",
"previousSignatureType": "DETACHED",
"currentSignatureType": "ATTACHED",
"signerInfo": {
"ownerCertificateInfo": {
"description": "Власник",
"value": {
"ownerSurname": {
"description": "Прізвище",
"value": "Тестовий"
},
"ownerGivenname": {
"description": "Імя по-батькові",
"value": "FIleContainer"
},
"ownerFullName": {
"description": "Повне ім'я",
"value": "Тестовый 33"
},
"ownerCountry": {
"description": "Країна",
"value": "UA"
},
"ownerRegion": {
"description": "Область",
"value": "Харківська"
},
"ownerCity": {
"description": "Місто",
"value": "Харків"
},
"ownerAddress": {
"description": "Поштова адреса",
"value": null
},
"ownerSerialNumber": {
"description": "Серійний номер власника",
"value": "CD60B227E5E700E1"
},
"ownerPosition": {
"description": "Посада",
"value": "Розробник"
},
"ownerOrganization": {
"description": "Організація",
"value": "Сайфер"
},
"ownerOrganizationUnit": {
"description": "Відділ (підрозділ)",
"value": "ІТ"
}
}
},
"issuerCertificateInfo": {
"description": "Видавник",
"value": {
"issuerOrganization": {
"description": "Організація",
"value": "ТОВ \"Сайфер БІС\""
},
"issuerDepartment": {
"description": "Підрозділ",
"value": "Центр сертифікації ключів"
},
"issuerFullName": {
"description": "Повне ім'я",
"value": "ЦСК ТОВ \"Сайфер БІС\""
},
"issuerCountry": {
"description": "Країна",
"value": "ua"
},
"issuerRegion": {
"description": "Область",
"value": null
},
"issuerCity": {
"description": "Місто",
"value": "Київ"
},
"issuerAddress": {
"description": "Поштова адреса",
"value": null
},
"issuerSerialNumber": {
"description": "Серійний номер видавця",
"value": "UA-33349855-0002"
}
}
},
"publicKeyCertificateInfo": {
"description": "Інформація про відкритий ключ",
"value": {
"publicKey": {
"description": "Відкритий ключ",
"value": "84 30 D6 9D 69 7B D7 77 3F 2E 13 44 56 7C 74 D2 6B FA D3 6E CF B8 AE D5 F6 87 44 9F A1 5F 7D BF 00"
},
"dsAlgorism": {
"description": "Алгоритм ЕП",
"value": "ДСТУ 4145-2002, ПБ, little-endian"
}
}
},
"certificateSerialNumber": {
"description": "Серійний номер сертифікату",
"value": "63 EF 3F 5D 24 76 4D 26"
},
"notBefore": {
"description": "Початок дії",
"value": "2018-09-26T06:30:35Z"
},
"notAfter": {
"description": "Закінчення дії",
"value": "2019-09-25T21:00:00Z"
},
"extensionsCertificateInfo": {
"description": "Розширення",
"value": {
"personalData": {
"description": "Персональні дані",
"value": {
"customId": {
"description": "Зовнішній ідентифікатор",
"value": "0033"
},
"passport": {
"description": "Паспортні дані",
"value": "АА000033"
},
"drfou": {
"description": "Реєстраційний номер облікової картки платника податків",
"value": "0000000033"
},
"edrpou": {
"description": "Код ЕДПРОУ",
"value": null
},
"eddrun": {
"description": "Унікальний номер запису в ЄДДР",
"value": "10000000000033"
}
}
},
"alternativeOwnerName": {
"description": "Альтернативне ім'я власника",
"value": "test@cipher.com.ua"
},
"subjectKeyId": {
"description": "Ідентифікатор ключа",
"value": "41 BB 81 56 29 F1 08 FD 48 F3 AF 19 D6 7B A8 4A 51 FA F4 AA 1C 20 1C 9A B4 A0 E5 73 08 20 00 9C"
},
"subjectOwnerIdissuerKeyId": {
"description": "Ідентифікатор власникаключа видавця",
"value": "CD20 60B4 B2E4 27ED E50D E730 0099 E1"
8C BE 30 6A 07 7D 69 9A 32 73 23 8A E9 09 08 71 D6 16 37 0E 18 E5 76 D4 },7F"
"certificateProfile": {},
"subjectOwnerId": "{
"description": "Ідентифікатор власника",
"value": "CD 60 B2 27 E5 E7 00 E1"
},
"certificateProfile": {
"description": "Профіль сертифіката",
"value": "3"
},
"keyUsage": {
"description": "Призначеня сертифіката",
"value": "Електронний підпис"
},
"isTemporary": {
"description": "Стартовий",
"value": "false"
},
"isReinforced": {
"description": "Посилений",
"value": "false"
}
}
}
}
}
]
} |
Пример кода на JavaScript + jQuery 2.2.4
| Code Block | ||
|---|---|---|
| ||
$.ajax({
url: ""https://localhost:9092local.cipher.kiev.ua:9090/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ds/modifier",
type: "GET",
dataType: "json",
cache: false
}).done(function (jsonResponse, textStatus, xhr) {
message = jsonResponse.message;
modifyResults = jsonResponse.modifyResults;
}).fail(function (xhr) {
try {
var jsonResponse = JSON.parse(xhr.responseText);
message = jsonResponse.message;
failureCause = jsonResponse.failureCause;
modifyResults = jsonResponse.modifyResults;
} catch (e) {
message = (xhr.responseText == undefined) ? "Ошибка при получении результата модификации ЭП." : xhr.responseText;
}
}) |
...