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

Compare with Current View Page History

« Previous Version 4 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-12", 
    "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-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
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