Сервис «Водитель»

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

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

В данной статье описывается сервис по получению данных (далее – Сервис) из базы данных «Водитель» автоматизированной информационной системы «Сервисный центр» Министерства внутренних дел Республики Казахстан (далее - БД Водитель) посредством информационной системы АО «Государственное кредитное бюро» (далее - ГКБ), методы запроса данных, примеры входных и выходных 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	Доступ запрещен

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

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