Versions Compared

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

Метод

POSTPUT

...

Параметри запиту

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

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

Отсутствует

Параметры JSON объекта запроса
Налаштовувані заголовки запиту
Content-Typeapplication/json
Параметри JSON обʼєкта запиту

ІмʼяИмя

Тип

ОбязательностьОбовʼязковість

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

hashAlgorithmStringfalsetrue

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

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

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

Геш, який має бути перевірений.

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

Хеш-данные, которые должны быть проверены в кодировке

Base64.

base64Data

String

false

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

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
true
-
хеш действителен
діючий геш
false -
хеш недействителен
недіючий геш
verifiedHash

Array[Integer]

trueХеш, который был получен для проверки

String

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

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

calculatedHash

Array[Integer]

trueХеш, который рассчитывается

String

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

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

algorithmString
trueХеш-алгоритм

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

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

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

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

...

messageStringОпис результату проведення операції
code

...

languagejs
StringКод операції
techMessageStringРозширений технічний опис

...