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

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

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

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

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

Адреса web сервисов:	Наименование элемента
Тестовый сервис	https://testscbws.mkb.kz/mtsznServices/DriversLicenseDetailsImplService?wsdl
Продуктивный сервис	https://scbws.mkb.kz/mtsznServices/DriversLicenseDetailsImplService?wsdl
Метод сервиса:	getDriversLicense

Введение

---

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

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	Да

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

---

Таблица 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	Да

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

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

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

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