Сервис «Водитель»: различия между версиями

Материал из Wiki ГКБ
Перейти к навигации Перейти к поиску
(на осн.комментарии Нураханова Б. getZipDriverPortType)
Строка 8: Строка 8:
 
</center>
 
</center>
 
<br/>
 
<br/>
 +
  
  
Строка 13: Строка 14:
  
  
−
=='''Описание сервиса DriversLicenseDetailsImplService'''==
+
=='''Описание сервиса getZipDriverPortType'''==
  
 
{| class="wikitable"
 
{| class="wikitable"
Строка 21: Строка 22:
 
|-
 
|-
 
| style="text-align: left;" | Тестовый сервис
 
| style="text-align: left;" | Тестовый сервис
−
| style="text-align: left;" | https://testscbws.mkb.kz/mtsznServices/DriversLicenseDetailsImplService?wsdl
+
| style="text-align: left;" | https://testscbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService
 
|-
 
|-
 
| style="text-align: left;" | Продуктивный сервис
 
| style="text-align: left;" | Продуктивный сервис
−
| style="text-align: left;" | https://scbws.mkb.kz/mtsznServices/DriversLicenseDetailsImplService?wsdl
+
| style="text-align: left;" | https://scbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService
 
|-
 
|-
 
| style="text-align: left;" | '''Метод сервиса:'''
 
| style="text-align: left;" | '''Метод сервиса:'''
−
| style="text-align: left;" | getDriversLicense
+
| style="text-align: left;" | getZipDriverPortType
 
|}
 
|}
  
Строка 109: Строка 110:
 
|
 
|
 
|}
 
|}
 +
 +
</div>
 +
</div>
 +
 +
 +
===Пример вызова метода getZipDriverPortType===
 +
-----
 +
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
 +
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0004" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Пример вызова метода с помощью SOAP запроса будет иметь следующий вид:''<small style="color:#0645ad;"> [Показать ответ] </small></div>
 +
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0004" style="padding:10px">
 +
<syntaxhighlight lang="xml">
 +
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
 +
  <soapenv:Header>
 +
      <userId>ID пользователя</userId>
 +
  </soapenv:Header>
 +
  <soapenv:Body>
 +
      <data:getZipDriverPortType>
 +
        <!--Optional:-->
 +
        <iin>ИИН</iin>
 +
        <requestNumber>Номер запроса</requestNumber>
 +
        <!--Optional:-->
 +
        <consentConfirmed>Подтверждение субъекта</consentConfirmed>
 +
      </data:getZipDriverPortType>
 +
  </soapenv:Body>
 +
</soapenv:Envelope>
 +
</syntaxhighlight>
 +
 +
 +
</div>
 +
</div>
 +
 +
<div style="border:1px solid #FFFFFF; margin-bottom:5px; margin-top:5px; overflow:hidden;">
 +
<div class="mw-customtoggle-myFAQ_DownloadPackagesGeneralIssues_Question_0005" style="background:#FFFFFF; border:1px solid #FFFFFF; color:#000000; padding-bottom:1px; padding-top:1px; padding-right:10px; padding-left:10px;">''Примеры ответа на вызов метода getZipDriverPortType''<small style="color:#0645ad;"> [Показать ответ] </small></div>
 +
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myFAQ_DownloadPackagesGeneralIssues_Question_0005" style="padding:10px">
 +
 +
<syntaxhighlight lang="xml">
 +
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 +
  <soap:Body>
 +
      <ns2:getZipDriverPortTypeResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/">
 +
        <return>
 +
            <responseInfo/>
 +
            <responseData>
 +
              <item>
 +
                  <firstName>Фамилия</firstName>
 +
                  <lastName>Имя</lastName>
 +
                  <middleName>Отчество</middleName>
 +
                  <dateOfBirth>Дата рождение</dateOfBirth>
 +
                  <dateOperate>Дата выдачи ВУ</dateOperate>
 +
                  <drivingDocDateEnd>Дата окончания ВУ</drivingDocDateEnd>
 +
                  <serial>Серия</serial>
 +
                  <num>Номер</num>
 +
                  <categoryA>false</categoryA>
 +
                  <categoryB>true</categoryB>
 +
                  <categoryC>false</categoryC>
 +
                  <categoryD>false</categoryD>
 +
                  <categoryE>false</categoryE>
 +
                  <categoryF>false</categoryF>
 +
                  <iin>ИИН</iin>
 +
                  <placeBirth>Место рождение</placeBirth>
 +
              </item>
 +
            </responseData>
 +
        </return>
 +
      </ns2:getZipDriverPortTypeResponse>
 +
  </soap:Body>
 +
</soap:Envelope>
 +
</syntaxhighlight>
 +
  
 
</div>
 
</div>
Строка 254: Строка 322:
  
  
−
=='''Обработка исключений метода getDriversLicense'''==
+
=='''Обработка исключений метода getZipDriverPortType'''==
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Строка 298: Строка 366:
 
{| width="auto" cellspacing="0" cellpadding="2" style="border:none;"
 
{| width="auto" cellspacing="0" cellpadding="2" style="border:none;"
 
| width="auto" valign="top"|
 
| width="auto" valign="top"|
−
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/ Главная страница]</span>
+
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://test-wiki.mkb.kz/ Главная страница]</span>
 
|
 
|
−
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://wiki.mkb.kz/w/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA_%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%B2_%D0%93%D0%91%D0%94 Предыдущая страница]</span>
+
| style="border-bottom:5px solid #20B2AA;font:110% Arial, Helvetica, sans-serif; color: #000000;text-align:center; padding-left:15px; padding-right:15px;" |<span class="plainlinks">[https://test-wiki.mkb.kz/w/%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D1%8B_%D0%93%D0%91%D0%94 Предыдущая страница]</span>
 
|}
 
|}
 
</center>
 
</center>
 
<br/>
 
<br/>

Версия от 04:14, 12 апреля 2023

Главная страница Предыдущая страница



В данной статье описывается сервис по получению данных (далее – Сервис) из базы данных «Водитель» автоматизированной информационной системы «Сервисный центр» Министерства внутренних дел Республики Казахстан (далее - БД Водитель) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных SOAP-запросов, возможные ошибки.


Описание сервиса getZipDriverPortType

Адреса web сервисов: Наименование элемента
Тестовый сервис https://testscbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService
Продуктивный сервис https://scbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService
Метод сервиса: getZipDriverPortType


Введение

При вызове веб-сервиса обязательно указываются следующие параметры:

1. ID и пароль клиента (организации) в HTTP Header, необходимые для базовой аутентификации. Так как коммуникация с веб-сервисами системы идет по защищенному протоколу HTTPS, то базовая аутентификация представляется безопасным решением.

2. ID пользователя, от имени которого будет выполнена запрашиваемая операция в SOAP Header:

Http Headers: {Authorization=[Basic jUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2]}

SOAP Message: [Показать ответ] 
1.	<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.mtszn.scb.kz">  
2.	    <soapenv:Header>  
3.	        <userId>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</userId>  
4.	    </soapenv:Header>  
5.	    <soapenv:Body>  
6.	        <data:getMethod/>  
7.	    </soapenv:Body>  
8.	</soapenv:Envelope>

где c3ZjUnB0U3lzdGVtQWNjb3VudDpBbzZVRkdyVTZ2 - есть значение HTTP Header, представляющее собой ID клиента и его пароль в формате «clientId:password» и кодировке Base64 как того требует механизм Basic Authentication.


Состав данных запроса на получение информации

Таблица 1. Состав данных запроса на получение информации [Показать ответ]
№ Наименование Поле Формат Обяза­тельность Примечание
1 ИИН субъекта iin xs:string Да Значение должно со­держать 12 цифр
2 Серия водительского удостоверения xs:string
3 Номер водительского удостоверения xs:string
4 Номер запроса requestNumber xs:string Да


Пример вызова метода getZipDriverPortType

Пример вызова метода с помощью SOAP запроса будет иметь следующий вид: [Показать ответ] 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data="http://data.gbd.chdb.scb.kz/">
   <soapenv:Header>
      <userId>ID пользователя</userId>
   </soapenv:Header>
   <soapenv:Body>
      <data:getZipDriverPortType>
         <!--Optional:-->
         <iin>ИИН</iin>
         <requestNumber>Номер запроса</requestNumber>
         <!--Optional:-->
         <consentConfirmed>Подтверждение субъекта</consentConfirmed>
      </data:getZipDriverPortType>
   </soapenv:Body>
</soapenv:Envelope>


Примеры ответа на вызов метода getZipDriverPortType [Показать ответ] 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getZipDriverPortTypeResponse xmlns:ns2="http://data.gbd.chdb.scb.kz/">
         <return>
            <responseInfo/>
            <responseData>
               <item>
                  <firstName>Фамилия</firstName>
                  <lastName>Имя</lastName>
                  <middleName>Отчество</middleName>
                  <dateOfBirth>Дата рождение</dateOfBirth>
                  <dateOperate>Дата выдачи ВУ</dateOperate>
                  <drivingDocDateEnd>Дата окончания ВУ</drivingDocDateEnd>
                  <serial>Серия</serial>
                  <num>Номер</num>
                  <categoryA>false</categoryA>
                  <categoryB>true</categoryB>
                  <categoryC>false</categoryC>
                  <categoryD>false</categoryD>
                  <categoryE>false</categoryE>
                  <categoryF>false</categoryF>
                  <iin>ИИН</iin>
                  <placeBirth>Место рождение</placeBirth>
               </item>
            </responseData>
         </return>
      </ns2:getZipDriverPortTypeResponse>
   </soap:Body>
</soap:Envelope>



Состав данных ответа на запрос получения информации

Таблица 2. Состав данных ответа на запрос получения информации [Показать ответ]
№ Наименование Поле Формат Обяза­тельность Примечание
1 ИИН iin xs:string Да
2 Фамилия lastName xs:string Да
3 Имя firstName xs:string Да
4 Отчество middleName xs:string Нет
5 Дата рождения dateOfBirth xs:date Да ГГГГ-ММ-ДД
6 Место рождения placeBirth xs:string Да
7 Место жительства placeLife xs:string Да
8 Дата операции (послед­него утверждения или выдачи водительского удостоверения) dateOperate xs:date Да
9 Дата окончания действия водительского удостове­рения drivingDocDateEnd xs:date Да
10 Серия водительского удостоверения serial xs:string Да
11 Номер водительского удостоверения num xs:string Да
12 Категория «A» categoryA xs:boolean Да
13 Категория «B» categoryB xs:boolean Да
14 Категория «C» categoryC xs:boolean Да
15 Категория «D» categoryD xs:boolean Да
16 Категория «E» categoryE xs:boolean Да
17 Категория «F» categoryF xs:boolean Да


Обработка исключений метода getZipDriverPortType

Код/Текст ошибки/сообщения Описание ошибки/сообщения Примечание
SBF-VE-8 Номер "ИИН" должен содержать 12 цифр
VAL-JSR-001 Обязательное поле "%s" отсутствует
SBF-AD-1 Пользователь «%s» не имеет прав для вы­пол­нения действия
Обязательное поле UserId отсутствует
FAULT-015 Сервис на стороне ГБД не досту­пен
IIN NOT FOUND ИИН не найден
SIGNATURE_NOT_VALID Отсутствует ЭЦП или ЭЦП не валидна
ACCESS_DENIED Доступ запрещен


Главная страница Предыдущая страница


Источник — https://wiki.gkb.kz/?title=Сервис_«Водитель»&oldid=6292