Басты бет

Өнімдер

Сатып алу

ГОСТ 2015

Көмек

Жүктемелер

Контактілер


KAZTOKEN desktop

KAZTOKEN desktop

KAZTOKEN жұмыс үстелі қолданбасы NCALayer қолданбасына ұқсас, мысалы, белгілі құрылғыларды бір рет басу арқылы қол қоюды және бір операцияда бірнеше файлға қол қоюды орындау үшін конфигурациялау мүмкіндігі сияқты қосымша мүмкіндіктері бар.

KAZTOKEN desktop 1.2.788.191

Операциялық жүйені қолдау:

  • Windows 8+

Сертификаттау органдарымен интеграция:

  • ҚР ҰОК

API қолдауы:

  • NCALayer (WebSocket)
    • Апплет
    • commonUtils
    • негіздері (бір операциямен бірнеше құжатқа қол қою мүмкіндігі қосылған)
  • SIGEX (HTTPS)
    • көп қол қою - 3-тен астам құжатқа қол қою үшін https://sigex.kz қызметінде Ірі бизнес белсенді жазылым қажет.

EDS негізгі медиа түрлерін қолдау:

  • KAZTOKEN (бүкіл өнім желісі)

Көп қолтаңба API (SIGEX) сипаттамасы

SIGEX үшін әзірленген көп қолтаңбалы API WebSocket протоколы арқылы жұмыс істейтін классикалық NCALayer API интерфейстерінен айырмашылығы, HTTPS протоколы арқылы жұмыс істейді, сондықтан осы API-ге сұраулар POST әдісі арқылы https: //127.0.0.1:24680/.

Бұл API деректер блоктарын қол қою үшін бөлек тасымалдауға мүмкіндік береді, соның арқасында бір операцияда қол қойылған құжаттар саны шектелмейді.

Қол қою екі кезеңде жүзеге асырылады:

  1. Көп қолтаңба операциясын тіркеу.
  2. Қол қою үшін деректердің жеке блоктарын беру.

Операциядан бас тартуға да болады.

Маңызды: бұл API жұмыс істеуі үшін қоңырау шалатын сервер Content-Security-Policy параметрін орнатуы қажет. Web/HTTP) тақырыбы /CSP) connect-src https://127.0.0.1:24680; мәні, әйтпесе браузер HTTP сұрауларындағы operationCookie cookie файлын KAZTOKEN мобильді/жұмыс үстеліне жібермейді және қоңыраулар 401 Рұқсатсыз» қайтарады. .

Multisignature API қолдауы ашық бастапқы JS кітапханасында ncalayer-js-client жүзеге асырылады.

Қол жетімділікті тексеру

Көп қолтаңбалы API қолжетімділігін тексеру үшін https://127.0.0.1:24680/ мекенжайына GET жіберуге болады.

Жауапта қолданба нұсқасы туралы ақпарат бар JSON болады.

Көп қолтаңба операциясын тіркеу

Операцияны тіркеу келесі JSON файлын POST әдісі арқылы https://127.0.0.1:24680/ мекенжайына жіберу арқылы орындалады:

{
   "Құжаттардың саны": 1,
   "base64": жалған,
   "incapsulateContent": жалған
}
  • numberOfDocuments - қанша құжатқа (файлға) қол қою керек;
  • base64 - қол қою сатысындағы деректер base64 жолдары түрінде жіберілетінін және қолданба сонымен қатар base64 кодталған жауаптарды қайтаратынын көрсететін жалауша;
  • incapsulateContent - қол қою кезеңінде деректер нәтижесінде қол қойылған CMS-де инкапсуляциялануы тиіс екенін көрсететін жалауша.

Сәтті тіркелгеннен кейін өтінім келесі қоңыраулар үшін қажетті келесі деректермен жауап қайтарады:

  • жауап денесі жол болады - операция идентификаторы operationId;
  • operationCookie`` cookie файлында (Set-Cookie`` жауап тақырыбы арқылы орнатылған) бірегей жол мәні болады - деректердің екінші бөлігі.
Жеке деректер блоктарын қол қоюға жіберу

Қол қоюға арналған деректер блоктарын POST әдісі арқылы https://127.0.0.1:24680/{operationId} мекенжайына жіберу керек ({operationId} орнына қол қою әрекетінің идентификаторын көрсету керек). Сондай-ақ, сұраудың бір бөлігі ретінде operationCookie cookie файлы тіркеу кезеңінде алынған мәнмен бірге жіберілуі керек. Қолданба процедураны тіркеу кезінде numberOfDocuments бөлімінде көрсетілген деректер блоктарын ғана өңдейді.

Егер base64 жалаушасы орнатылған болса, онда деректер base64 кодында, әйтпесе екілік пішінде берілуі керек.

Қол қою сәтті болса, қолданба 200 күйімен және жауап органы ретінде жасалған CMS қолтаңбасымен жауап береді. Егер base64 жалаушасы орнатылған болса, қолтаңба base64 кодталады, әйтпесе қолданба оны екілік пішінде қайтарады.

Операцияны тоқтату

Көп қол қою операциясынан бас тарту үшін https://127.0.0.1:24680/{operationId}/cancel мекенжайына POST жіберу керек ({operationId} орнына идентификаторды көрсету керек: қол қою операциясы). Сондай-ақ, сұраудың бір бөлігі ретінде `operationCookie`` cookie файлы тіркеу кезеңінде алынған мәнмен бірге жіберілуі керек. Бұл сұраудың негізгі бөлігі бос болуы керек.

Қателер

Егер қызмет қандай да бір себептермен сұрауды өңдей алмаса, ол жауап органы ретінде 200-ден басқа кодпен жауап қайтарады, ол қысқаша сипаттамасы бар жолды қайтарады:

  • 403 Тыйым салынған - басқа операция орындалып жатқанда көп қолтаңбаны бастау әрекеті кезінде;
  • 400 BadRequest – сұранысқа қатысты техникалық ақаулар (сұраныс толығымен алынбаған немесе сұрау құрылымы дұрыс емес);
  • 500 InternalServerError - қолданбада күтпеген қате орын алды (мысалы, қолтаңбаны жасау кезіндегі ерекшелік);
  • 409 қақтығыс - пайдаланушы көп қолтаңба үшін кілтті таңдау кезінде «Бас тарту» түймесін басқан;
  • 402 PaymentRequired - көп қолтаңба үшін таңдалған кілт жарамды SIGEX корпоративтік жазылымы бар ұйым қызметкерінің кілті емес;
  • 401 Рұқсат етілмеген - қате көп қол қою процедурасының идентификаторы operationId немесе cookie operationCookie пайдаланылады (атап айтқанда, егер пайдаланушы көп қол қою процесі кезінде «Бас тарту» түймесін басқанда және операция әлдеқашан аяқталса);
  • 404 NotFound - сұраудағы жол дұрыс емес.


©2024 ТОО "Цифровой поток - Инновации".