Перейти до основного вмісту

Отримати список підписантів

URI: /api/v2/parse-signers

Метод використовується для отримання списку підписантів файлу.

Запит виконується методом POST у json форматі.

⚠️ Запит повинен містити заголовок Accept: application/json

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

Ім'яТипОбов'язковийОпис
signedstringТакПідписаний зміст файлу, закодований base64

Приклад запиту​

Запит: /api/v2/parse-signers
{
   "signed": "base64 signed file content"
}

Параметри відповіді​

Ім'яТипОпис
signersarrayІнформація про сертифікати підписантів
signers.isFilledbooleanВідмітка про заповненість сертифіката
signers.versionnumberВерсія структури з сертифікатом
signers.issuerstringРеквізити ЦСК, що видав сертифікат
signers.issuerCNstringІм'я ЦСК, що видав сертифікат
signers.serialstringСерійний номер сертифіката
signers.subjectstringРеквізити власника сертифіката
signers.subjCNstringІм'я власника сертифіката
signers.subjOrgstringОрганізація до якої належить власник сертифіката
signers.subjOrgUnitstringПідрозділ організації до якої належить власник сертифіката
signers.subjTitlestringПосада власника сертифіката
signers.subjStatestringНазва області до якої належить власник сертифіката
signers.subjLocalitystringНазва населеного пункту до якого належить власник сертифіката
signers.subjFullNamestringПовне ім'я власника сертифіката
signers.subjAddressstringАдреса власника сертифіката
signers.subjPhonestringНомер телефона власника сертифіката
signers.subjEMailstringE-mail власника сертифіката
signers.subjDNSstringDNS-ім`я технічного засобу
signers.subjEDRPOUCodestringКод ЕДРПОУ власника сертифіката
signers.subjDRFOCodestringКод ДРФО власника сертифіката
signers.subjNBUCodestringІдентифікатор НБУ власника сертифіката
signers.subjSPFMCodestringІдентифікатор СПФМ власника сертифіката
signers.subjOCodestringКод організації власника сертифіката
signers.subjOUCodestringКод підрозділу власника сертифіката
signers.subjUserCodestringКод користувача власника сертифіката
signers.certBeginTimestringЧас введення сертифіката в дію в форматі MM.DD.YYYY HH:ii:ss
signers.certEndTimestringЧас закінчення дії сертифіката в форматі MM.DD.YYYY HH:ii:ss
signers.isPrivKeyTimesAvailbooleanОзнака наявності строку дії особистого ключа
signers.privKeyBeginTimestringЧас введення в дію особистого ключа в форматі MM.DD.YYYY HH:ii:ss
signers.privKeyEndTimestringЧас виведення з дії особистого ключа в форматі MM.DD.YYYY HH:ii:ss
signers.publicKeyBitsnumberДовжина відкритого ключа в бітах
signers.publicKeystringВідкритий ключ у вигляді строки
signers.publicKeyIDstringІдентифікатор відкритого ключа у вигляді строки
signers.issuerPublicKeyIDstringІдентифікатор відкритого ключа ЦСК у вигляді строки
signers.keyUsagestringВикористання ключів у вигляді строки
signers.extKeyUsagesstringУточнене призначення ключів
signers.policiesstringПравила сертифікації
signers.crlDistribPoint1stringТочка доступу до повних СВС
signers.crlDistribPoint2stringТочка доступу до часткових СВС
signers.isPowerCertbooleanОзнака того, що сертифікат посилений
signers.isSubjTypeAvailbooleanОзнака наявності типу власника сертифіката
signers.isSubjCAbooleanОзнака того, що власник сертифікату ЦСК
signers.chainLengthbooleanОбмеження на довжину ланцюжка сертифікатів
signers.UPNstringUPN-ім`я власника сертифіката
signers.publicKeyTypenumberТип відкритого ключа
signers.keyUsageTypenumberТип використання ключів
signers.RSAModulstringМодуль RSA у вигляді строки
signers.RSAExponentstringЕкспонента RSA у вигляді строки
signers.OCSPAccessInfostringТочка доступу до OCSP-сервера
signers.issuerAccessInfostringТочка доступу до сертифікатів
signers.TSPAccessInfostringТочка доступу до TSP-сервера
signers.isLimitValueAvailablebooleanПризнак наявності обмеження на транзакцію
signers.limitValuenumberМаксимальне обмеження на транзакцію
signers.limitValueCurrencystringВалюта максимального обмеження на транзакцію
signers.subjTypenumberТип власника сертифіката
signers.subjSubTypenumberПідтип власника сертифіката
signers.subjUNZRstringНомер УНЗР власника сертифіката
signers.subjCountrystringКод країни власника сертифіката
signers.fingerprintstringВідбиток сертифіката
signers.isQSCDbooleanОзнака генерації ключа на захищений носій
signers.subjUserIDstringІдентифікатор власника сертифіката
signers.namestringІм'я власника сертифіката
signers.fullNamestringПовне ім'я власника сертифіката
signers.positionstringПосада власника сертифіката
signers.organizationstringОрганізація до якої належить власник сертифіката
signers.edrpoustringКод ЕДРПОУ власника сертифіката
signers.drfostringКод ДРФО власника сертифіката
signers.certificateStartDatestringЧас введення сертифіката в дію в форматі MM.DD.YYYY HH:ii:ss
signers.certificateEndDatestringЧас закінчення дії сертифіката в форматі MM.DD.YYYY HH:ii:ss
signers.countrystringКод країни власника сертифіката
signers.regionstringНазва області до якої належить власник сертифіката
signers.localitystringНазва населеного пункту до якого належить власник сертифіката
signers.addressstringАдреса власника сертифіката
signers.phonestringНомер телефона власника сертифіката
signers.emailstringE-mail власника сертифіката
signers.isDigitalStampbooleanОзнака цифрової печатки

Приклад успішної відповіді​

200 OK

Відповідь: /api/v2/parse-signers
{
    "signers": [
        {
            "isFilled": true,
            "version": 8,
            "issuer": "O=ТОВ \"Центр сертифікації ключів \"Україна\";CN=КНЕДП ТОВ \"Центр сертифікації ключів \"Україна\";Serial=UA-36865753-2101;C=UA;L=Київ;OI=NTRUA-36865753",
            "issuerCN": "КНЕДП ТОВ \"Центр сертифікації ключів \"Україна\"",
            "serial": "73FA780700000000000000000000000000000001",
            "subject": "O=Смарт Трейд(Тестовий сертифікат);Title=Директор;PostalCode=03150;CN=Шевчук Артемій;SN=Шевчук;GivenName=Артемій;Serial=3579415015D;C=UA;L=КИЇВ;StreetAddress=Антоновича",
            "subjCN": "Іванов Іван",
            "subjOrg": "Смарт Трейд(Тестовий сертифікат)",
            "subjOrgUnit": "",
            "subjTitle": "Директор",
            "subjState": "",
            "subjLocality": "КИЇВ",
            "subjFullName": "Іванов Іван",
            "subjAddress": "Антоновича",
            "subjPhone": "",
            "subjEMail": "[email protected]",
            "subjDNS": "",
            "subjEDRPOUCode": "20211116",
            "subjDRFOCode": "3579415015",
            "subjNBUCode": "",
            "subjSPFMCode": "",
            "subjOCode": "",
            "subjOUCode": "",
            "subjUserCode": "",
            "certBeginTime": "11.16.2021 12:28:26",
            "certEndTime": "11.15.2023 23:59:59",
            "isPrivKeyTimesAvail": false,
            "privKeyBeginTime": "11.16.2021 12:28:26",
            "privKeyEndTime": "11.15.2023 23:59:59",
            "publicKeyBits": 264,
            "publicKey": "1E 66 7F C7 DB 0C BC 21 1A C7 FA 74 13 EB C9 38 22 B4 A8 42 01 A6 66 EF 6B 69 E0 4C 5B AE 8C 03 00 ",
            "publicKeyID": "AB 4F DF BE CB 1B 00 BA FF DC C8 68 5F 72 41 5E 35 5F FE 8D DE 02 6A 10 01 70 82 C3 60 BF B7 F0 ",
            "issuerPublicKeyID": "52 ED 74 ED 3A E9 49 36 C5 78 B5 A0 60 0B 65 F1 10 09 BF EF 5F 1E ED 43 CD 23 A4 98 F0 7D E3 80 ",
            "keyUsage": "ЕЦП, Неспростовність",
            "extKeyUsages": "1.2.804.2.1.1.1.11.36865753.1",
            "policies": "Правила посиленої сертифікації",
            "crlDistribPoint1": "http://uakey.com.ua/list.crl",
            "crlDistribPoint2": "http://uakey.com.ua/list-delta.crl",
            "isPowerCert": true,
            "isSubjTypeAvail": false,
            "isSubjCA": false,
            "chainLength": false,
            "UPN": "",
            "publicKeyType": 1,
            "keyUsageType": 3,
            "RSAModul": "",
            "RSAExponent": "",
            "OCSPAccessInfo": "http://uakey.com.ua/services/ocsp/",
            "issuerAccessInfo": "http://uakey.com.ua/uakeycert.p7b",
            "TSPAccessInfo": "http://uakey.com.ua/services/tsp/",
            "isLimitValueAvailable": false,
            "limitValue": 0,
            "limitValueCurrency": "",
            "subjType": 4,
            "subjSubType": 0,
            "subjUNZR": "",
            "subjCountry": "UA",
            "fingerprint": "",
            "isQSCD": false,
            "subjUserID": "",
            "name": "Іванов Іван",
            "fullName": "Іванов Іван",
            "position": "Директор",
            "organization": "Смарт Трейд(Тестовий сертифікат)",
            "edrpou": "12345678",
            "drfo": "1234567890",
            "certificateStartDate": "2021-11-16 12:28:26",
            "certificateEndDate": "2023-11-15 23:59:59",
            "country": "UA",
            "region": "",
            "locality": "КИЇВ",
            "address": "Антоновича",
            "phone": "",
            "email": "[email protected]",
            "isDigitalStamp": false
        }
    ]
}