Versions Compared

Key

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

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

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

https://signer.cipher.kiev.ua/api/v1/ticket/{uuid}/ds/verifier

Метод

GET

Параметри запиту
uuidStringІдентифікатор сесії
Налаштовувані заголовки запиту

Відсутні

Відповідь
Код відповідіContent-typeДопустимі параметриПриклад вмісту
200application/jsonmessage
verifyResults 
{
"message" : "Електронний підпис дійсний.",
"verifyResults" : Array
}
503application/jsonmessage
{
   "message" : "Сервіс виконання криптографічних операцій не запущено."
}
400application/jsonmessage
{
   "message" : "Сесія відсутня."
}
406application/jsonmessage
verifyResults
failureCause
{
   "message" : "Електронний підпис не дійсний.",
"failureCause" : "",
"verifyResults" : Array
}
Параметри JSON обʼєкта відповіді
ПараметрТип данихОпис
messageStringОпис результату проведення операції
failureCause StringОпис причини виникнення помилки, яка зʼявилась при виконанні запиту на перевірку ЕП
verifyResultsArrayРезультати перевірки окремо по кожній з ЕП

...

ПолеТип данихОпис
isValidBooleantrue - ЕПЧ дійсна
false - ЕПЧ недійсна
isFailureBooleantrue - при перевірці ЕПЧ виникла помилка
false - при перевірці ЕПЧ помилок не виникло
dateTimeDateTimeЗначення дати та часу в форматі ISO 8601, яке завірено ЕПЧ
tsaCertificateSerialNumberObject*Серійний номер сертифікату TSP-сервера

Поля обʼєкта

Anchor
signerInfo
signerInfo
signerInfo

ПолеТип данихОпис
Отримання результату перевірки ЕПownerCertificateInfoObject*Інформація про власника
Отримання результату перевірки ЕПissuerCertificateInfoObject*Інформація про видавця
Отримання результату перевірки ЕПpublicKeyCertificateInfoObject*Інформація про відкритий ключ
certificateSerialNumberObject*Серійний номер сертифікату
notBeforeObject*Початок дії
notAfterObject*Завершення дії
Отримання результату перевірки ЕПextensionsCertificateInfoObject*Розширення

Поля обʼєкта

Anchor
ownerCertificateInfo
ownerCertificateInfo
Отримання результату перевірки ЕПsignerInfo.ownerCertificateInfo.value

ПолеТип данихОпис
ownerSurnameObject*Прізвище
ownerGivennameObject*Імʼя по батькові
ownerFullNameObject*Повне імʼя
ownerCountryObject*Країна
ownerRegionObject*Область
ownerCityObject*Населений пункт
ownerAddressObject*Поштова адреса
ownerSerialNumberObject*Серійний номер власника
ownerPositionObject*Посада

Поля обʼєкта 

Anchor
issuerCertificateInfo
issuerCertificateInfo
 Отримання результату перевірки ЕПsignerInfo.issuerCertificateInfo.value

ПолеТип данихОпис
issuerOrganizationObject*Організація
issuerDepartmentObject*Підрозділ
issuerFullNameObject*Повне імʼя
issuerCountryObject*Країна
issuerRegionObject*Область
issuerCityObject*Населений пункт
issuerAddressObject*Поштова адреса
issuerSerialNumberObject*Серійний номер видавця

Поля обʼєкта 

Anchor
publicKeyCertificateInfo
publicKeyCertificateInfo
Отримання результату перевірки ЕПsignerInfo.publicKeyCertificateInfo.value

ПолеТип данихОпис
publicKeyObject*Відкритий ключ
dsAlgorismObject*Алгоритм ЕП

Поля обʼєкта 

Anchor
extensionsCertificateInfo
extensionsCertificateInfo
Отримання результату перевірки ЕПsignerInfo.extensionsCertificateInfo.value

ПолеТип данихОпис
Отримання результату перевірки ЕПpersonalDataObject*Персональні дані
alternativeOwnerNameObject*Алтернативне імʼя власника
subjectKeyIdObject*Ідентифікатор ключа
issuerKeyIdObject*Ідентифікатор ключа видавця
subjectOwnerIdObject*Ідентифікатор власника
certificateProfileObject*Профіль сертифікату
keyUsageObject*Призначення сертифікату
isTemporaryObject*Ознака стартового сертифікату
isReinforcedObject*Ознанка посиленого сертифікату
isQualifiedObject*Ознака кваліфікованого сертифікату
isPrivateKeyOnQSCDObject*Ознака засобів КЕП
qscdTypeNameObject*Тип засобу КЕП
isElectronicStampObject*Ознака електронної печатки

Поля обʼєкта 

Anchor
personalData
personalData
Отримання результату перевірки ЕП.Отримання результату перевірки ЕПsignerInfo.extensionsCertificateInfo.value.personalData.value   

ПолеТип данихОпис
customIdObject*Зовнішній ідентифікатор
passportObject*Паспортні дані
drfouObject*Реєстраційний номер облікової картки платника податків

edrpou

Object*Код ЄДРПОУ

eddrun

Object*

Унікальний номер запису в ЄДР

...