Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Запрос служит для получения результата проверки ЭПхеша. Запрос является блокирующим, то есть результат будет получен только после завершения процесса проверки ЭПхеша, если такой был ранее запущен. Если ЭП действительнахеш действительный, будет возвращен HTTP статус код 200. Если в ЭП хеш не действительна действительный или в процессе ее непосредственной проверки возникли ошибки, будет возвращен HTTP статус код 406. При возникновении других типов ошибок, возвращаются HTTP статус коды 503 500 или 400.

URL-адрес запроса

https:///localhost:9092ccs-dev-api.cipher.kiev.ua/ccs/hash/api/v1/ticketcontext/{uuidcontextId}/ds/verifier

Метод

GET

Параметры запроса
uuidcontextIdStringfalseИдентификатор сессии
Настраиваемые заголовки запроса

Отсутствует

Ответ
Код ответаContent-typeДопустимые параметрыПример содержимого
200application/json

message

code

verifyResults 

techMessage

{
"message" : "
Электронная
Операція 
подпись
успішно 
действительна.
виконана", 
"
verifyResults
code" : 
Array
}503application/jsonmessage
{
    "message" : "Сервис выполнения криптографических операций не запущен."
}
400application/jsonmessage
{
    "message" : "Сессия отсутствует."
}
406
"CCSCLIB-14", 
"techMessage" : "OperationId:HASH_VERIFY"

}
202application/json

message

verifyResults

code

failureCause

techMessage

{
    "message" : "
Электронная подпись не действительна.",
Операція знаходиться в черзі на виконання", 
"
failureCause
code" : "CCSCLIB-12", 
"
verifyResults
techMessage" : 
Array
"OperationId:HASH_VERIFY"
}
Параметры JSON объекта ответа
202application/json
ПараметрТип данныхОписание

message

StringОписание результата проведения операцииfailureCause StringОписание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭПverifyResultsArrayРезультаты проверки отдельно по каждой из ЭП

Поля элемента массива verifyResults

...

Для проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времени.
true - ЭП действительна
false - ЭП недействительна

Поля объекта contentTimestamp, элемента массива signatureTimestamps

...

edrpou

...

eddrun

...

Уникальный номер записи в ЕГДР

code

techMessage

{

...

Пример объекта signerInfo

...

    "message

...

"

...

 

...

:

...

 

...

"Операція знаходиться на виконанні", 

...

"code" : "

...

CCSCLIB-13",

...

 

...

"techMessage" : "OperationId:HASH_VERIFY"
}
400application/json

message

code

techMessage

{
    "message" : "Операція ще не була запущена",
"code" : "CCSCLIB-11",
"techMessage" : "OperationId:HASH_VERIFY"

}
500application/json

message

code

techMessage

{

    "message" : "Виконання операції завершено, але результат виконання не визначений", 
"code" : "CCSCLIB-16",
"techMessage" : "OperationId:HASH_VERIFY"

}

500application/json

message

code

techMessage

{
    "message" : "Виникла помилка під час виконаня операції",
"code" : "CCSCLIB-15",
"techMessage" : "OperationId:HASH_VERIFY"

}
Параметры JSON объекта ответа
ПараметрТип данныхОписание
messageStringОписание результата проведения операции
codeStringКод операции
techMessageStringРасширенное техническое описание.
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
var settings = {
  "url": "https://ccs-dev-api.cipher.kiev.ua/ccs/hash/api/v1/context/cacba9d7-009c-4e5f-a6a0-d1ff0497894a/verifier",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({"hashAlgorithm":"GOST3411","hashBase64Data":"jabeLG+ohrhz1q6Se04wTYHkUz5XymHj0tttzSwXm2s="}),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
$.ajax({
    url: "https://localhost:9092/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ds/verifier",
    type: "GET",
    dataType: "json",
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
    verifyResults = jsonResponse.verifyResults;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause; 
        verifyResults = jsonResponse.verifyResults;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Ошибка при получении результата проверки ЭП." : xhr.responseText;
    }
})