Versions Compared

Old Version 17

changes.mady.by.user Alexandr Stokipny

Saved on

compared with

New Version 18

changes.mady.by.user Svitlana Nimych

Saved on

Key

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

Запрос Запит для получения отримання JSON, который содержит результат проверки хешаякий містить результат перевірки гешу.

URL-

...

адреса запиту

https://ccs-dev-api.cipher.kiev.ua/ccs/hash/api/v1/context/{contextId}/verifier/data

Метод

GET

...

Параметри запиту
contextIdStringtrueИдентификатор сессииІдентифікатор сесії

...

Налаштовувані заголовки

...

запиту

ОтсутствуетВідсутні

...

ВІдповідь
Код ответавідповідіContent-typeДопустимые параметрыДопустимі параметриПриклад вмістуПример содержимого
200application/json

valid
verifiedHash
calculatedHash
algorithm


{
    "valid": true,
    "verifiedHash": "jabeLG+ohrhz1q6Se04wTYHkUz5XymHj0tttzSwXm2s=",
    "calculatedHash": "jabeLG+ohrhz1q6Se04wTYHkUz5XymHj0tttzSwXm2s=",
    "algorithm": "GOST3411"
}
400, 500application/json

message
code
techMessage

{
    "message": "Контексту операції не існує",
    "code": "CCSCLIB-5",
    "techMessage": ""
}

...

Параметри JSON

...

обʼєкта відповіді

ИмяІмʼя

Тип данныхданих

ОписаниеОпис

validBoolean

true - хеш действителендіючий геш
false - хеш недействителеннедіючий геш

verifiedHash

String

Геш, який був завантажений для перевірки.

Доступні значення: дані в кодуванні

Хеш, который был загружен для проверки.

Допустимые значения: данные в кодировке Base64.

calculatedHash

String

Геш, який був обчислено під час перевірки.

Доступні значення: дані в кодуванні

Хеш, который был вычислен во время проверки.

Допустимые значения: данные в кодировке Base64.

algorithmString

Идентификатор хешІдентифікатор геш-алгоритмаалгоритму.

Допустимые значенияДоступні значення:

  • SHA1,
  • SHA224,
  • SHA256,
  • SHA384,
  • SHA512,
  • SHA512256,
  • SHA512224,
  • GOST3411,
  • DSTU7564256,
  • DSTU7564384,
  • DSTU7564512
messageStringОписание результата проведения операцииОпис результату проведення операції
codeStringКод операцииоперації
techMessageStringРасширенное техническое описаниеРозширений технічний опис


Приклад коду Пример кода на JavaScript + jQuery 2.2.4

Code Block
languagejs
$.ajax({
    url: "https://localhost:9092/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ds/base64SignedData",
    type: "GET",
    dataType: "json",
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
    dsData = jsonResponse.base64Data;
    message = "ПодписанныеПідписані данныедані успешноуспішно полученыотримані.";
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "ОшибкаПомилка при полученииотриманні подписанныхпідписаних данныхданих." : xhr.responseText;
    }
})

...