Versions Compared

Old Version 5

changes.mady.by.user Svitlana Nimych

Saved on

compared with

New Version 6

changes.mady.by.user Alexandr Stokipny

Saved on

Key

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

Метод позволяет проверить хеш за один запрос.

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

https://ccs-dev-api.cipher.kiev.ua/ccs/hash/api/v1/function

Метод

PUT

Параметры запроса

Отсутствует

Настраиваемые заголовки запроса

...

Content-Typeapplication/json
Параметры JSON объекта запроса

Имя

Тип

Обязательность

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

hashAlgorithmStringtrue

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

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

  • SHA1,
  • SHA224,
  • SHA256,
  • SHA384,
  • SHA512,
  • SHA512256,
  • SHA512224,
  • GOST3411,
  • DSTU7564256,
  • DSTU7564384,
  • DSTU7564512
hashBase64DataStringtrue

Хеш

-данные

,

которые должны быть проверены

который должен быть проверен.

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

base64Data

String

true

Данные, для которых был ранее вычислен хеш.

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

, на которые рассчитывается хеш

.

Ответ
Код ответаContent-typeДопустимые параметрыПример содержимого
200application/jsonvalid
verifiedHash
calculatedHash
algorithm
{
    "valid": true,
    "verifiedHash": "nL847emX3ERvDGiPwnH+bZjUTm3vsXvQV6+bs6LOEbQ=",
    "calculatedHash": "nL847emX3ERvDGiPwnH+bZjUTm3vsXvQV6+bs6LOEbQ=",
    "algorithm": "GOST3411"
}
400, 500application/json

message
code
techMessage

{
    "message": "Контексту операції не існує",
    "code": "CCSCLIB-5",
    "techMessage": ""
}
Параметры JSON объекта ответа
ПараметрТип данныхОписание
Допустимые значения
validBooleantrue - хеш действителен
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
var settings = {
  "url": "https://ccs-dev-api.cipher.kiev.ua/ccs/hash/api/v1/function",
  "method": "PUT",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json"
  },
  "data": JSON.stringify({"hashAlgorithm":"GOST3411","hashBase64Data":"nL847emX3ERvDGiPwnH+bZjUTm3vsXvQV6+bs6LOEbQ=","base64Data":"MzMz"}),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

...