You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

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

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

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

Метод

GET

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

Отсутствует

Параметры JSON объекта запроса

Имя

Тип

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

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

hashAlgorithmStringfalse

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

Должен быть один  [SHA1, SHA224, SHA256, SHA384, SHA512, SHA512256, SHA512224, GOST3411, DSTU7564256, DSTU7564384, DSTU7564512]

hashBase64DataStringfalseХеш-данные, которые должны быть проверены в кодировке Base64.
Ответ
Код ответаContent-typeДопустимые параметрыПример содержимого
200application/json

message
code
techMessage

{
    "message" : "Операція успішно виконана", 
    "code" : "CCSCLIB-14", 
    "techMessage" : "OperationId:HASH_VERIFY"
}
202application/json

message
code
techMessage

{
    "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-15", 
    "techMessage" : "OperationId:HASH_VERIFY"
}
Параметры JSON объекта ответа
ПараметрТип данныхОписание
messageStringОписание результата проведения операции
codeStringКод операции
techMessageStringРасширенное техническое описание.
Пример кода на JavaScript + jQuery 2.2.4
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);
});
  • No labels