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

Текущая версия от 08:48, 9 октября 2023

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

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

Адреса web сервисов:	Наименование элемента
Тестовый сервис	https://testscbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService?wsdl
Продуктивный сервис	https://scbws.mkb.kz/gbdServices/ZipDriverPortTypeImplService?wsdl
Метод сервиса:	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	Номер запроса	requestNumber	xs:string	Да
3	Подтверждение субъекта	consentConfirmed	xs:integer	Да

Пример вызова метода 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	Доступ запрещен

Главная страница

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

@@ Строка 13: / Строка 13: @@
-=='''Описание сервиса DriversLicenseDetailsImplService'''==
+=='''Описание сервиса getZipDriverPortType'''==
 {| class="wikitable"
@@ Строка 21: / Строка 21: @@
 |-
 | 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?wsdl
 |-
 | 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?wsdl
 |-
 | style="text-align: left;" | '''Метод сервиса:'''
-| style="text-align: left;" | getDriversLicense
+| style="text-align: left;" | getZipDriverPortType
 |}
@@ Строка 89: / Строка 89: @@
 |-
 |2
-|Серия водительского удостоверения
+|Номер запроса
-|
+|requestNumber
 |xs:string
-|
+|Да
 |
 |-
 |3
-|Номер водительского удостоверения
+|Подтверждение субъекта
-|
+|consentConfirmed
-|xs:string
+|xs:integer
-|
-|
-|-
-|4
-|Номер запроса
-|requestNumber
-|xs:string
 |Да
 |
 |}
+</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>
@@ Строка 254: / Строка 314: @@
-=='''Обработка исключений метода getDriversLicense'''==
+=='''Обработка исключений метода getZipDriverPortType'''==
 {| class="wikitable"
 |-
@@ Строка 298: / Строка 358: @@
 {| width="auto" cellspacing="0" cellpadding="2" style="border:none;"
 | 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>
 <br/>