Интерфейс X11

Интерфейс X11. Получение информации из аттестата владельца по WM-идентификатору.

<request>
	<wmid></wmid>
	<passportwmid></passportwmid>
	<sign></sign>
		<params>
			<dict></dict>
			<info></info>
			<mode></mode>
		</params>
</request>
  • параметры запроса:
название назначение примечание
wmid WM-идентификатор, подписавший запрос. Только WM Keeper Classic 12 цифр
passportwmid WM-идентификатор аттестата 12 цифр обязательный параметр
sign подпись запроса сформированная с помощью модуля WMSigner Подпись запроса формируется из параметров: wmid & passportwmid
params параметры запроса
params/dict отображение “опорного словаря” В структуре возвращаемых некоторые значения заменяются специальным кодом (Например, тип аттестата формальный представляется цифрой 110, начальный – 120, персональный – 130, продавца – 135). Словарь позволяет ознакомиться со всеми значениями и использовать их при работе с данным интерфейсом. Если dict=“1” – словарь отображается. Если dict=“0”(установлено по умолчанию) – словарь не отображается.
params/info отображение персональных данных(паспортные данные+контактная информация) владельца аттестата Если info=“1”(установлено по умолчанию) – персональные данные отображаются. Если info=“0” – персональные данные не отображаются
params/mode проверка принадлежности WM-идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата Каждый владелец аттестата может добавить в список доверенных любой WM-идентификатор. Доверенный идентификатор получает возможность просмотра всех данных аттестата, даже тех, которые заблокированы для публичного просмотра. Если mode=“1” – проверка принадлежности WM-идентификатора, подписавшего запрос, списку доверенных идентификаторов для проверяемого аттестата осуществляется. Если mode=“0”(установлено по умолчанию)- проверка не производится

Использовать аутентификацию с использованием ключей WM Keeper Classic в запросе необходимо лишь в случае если WMID, подписывающий запрос является доверенным идентификатором для проверяемого аттестата. Установка доверительных отношений производится на сайте центра аттестации. Доверенные WMID могут просматривать все персональные данные владельца аттестата, даже если их видимость была заблокирована владельцем аттестата. Оказание доверия является добровольной операцией, выполняемой владельцем аттестата, который при помощи специального интерфейса может вносить в список доверенных или удалить из него любой WMID.
Если доверительных отношений между проверяемым WMID и WMID, подписавшим запрос нет, то в запросе можно указать лишь параметр passportwmid. Структура запроса (наличие в нем всех описанных ранее тегов) должна быть неизменной в любом случае.

  • полный формат ответа:
<?xml version="1.0" encoding="windows-1251"?>
<response retval="">
<fullaccess></fullaccess>
	<certinfo wmid="">
		<attestat>
		<row cid="" regcid="" tid="" locked="" admlocked="" recalled="" datecrt="" datediff="" regnickname="" regwmid=""/>
		</attestat>
		<wmids>
			<row wmid="" info="" nickname="" datereg="" yearreg="" monthreg="" dayreg="" timereg="" ctype="" companyname="" companyid="" phone="" email="" phone-check-lock="" email-check-lock=""/>
		</wmids>
		<userinfo>
			<value>
				<row locked="" nickname="" infoopen="" city="" region="" citid=""
 countryid="" country="" zipcode="" adres="" fname="" iname="" oname="" pnomer="" pdate="" pday="" pmonth="" pyear="" pcountryid="" pcountry="" pcity="" pbywhom="" rcountryid="" rcountry="" rcity="" radres="" bplace="" bday="" bmonth="" byear="" name="" icq="" phone="" email="" web="" cap_owner="" pasdoc="" inndoc="" jabberid="" sex=""/>
			</value>
			<check-lock>
				<row nickname="" infoopen="" city="" region="" country="" adres="" zipcode="" fname="" iname="" oname="" pnomer="" pdate="" pbywhom="" pcountry="" pcity="" rcountry="" rcity="" radres="" bplace="" bday="" inn="" name="" email="" web="" phone="" icq="" jabberid="" sex=""/>
			</check-lock>
			<weblist>
				<row url="" check-lock="" ischeck="" islock=""/>
			</weblist>
			<extendeddata>
				<row type="" account="" check-lock=""/>
			</extendeddata>
		</userinfo>
	</certinfo>
</response>
  • параметры ответа:
название назначение примечание
response/@retval код выполнения запроса retval=0 – запрос выполнен без ошибок
retval=1 – запрос не выполнен (неверный формат запроса)
retval=2 – запрос не выполнен (неверно указан параметр passportwmid)
retval=4 – запрос не выполнен (ошибка при проверке подписи)
retval=11 – запрос не выполнен (не указан один из параметров)
fullaccess индикатор наличия доступа к закрытым полям аттестата Если fullaccess=1, значит владелец проверяемого WMID добавил WMID, подписывающий запрос в список доверенных и тем самым предоставил доступ к своим персональным данным. Если fullaccess=0, значит доступа к закрытым полям аттестата проверяемого WMID нет
response/certinfo информация об аттестате
response/certinfo/@wmid WM-идентификатор аттестата
response/certinfo/directory Опорный словарь ctype – юридический статус владельца аттестата (частное лицо или юридическое)
tid – тип аттестата
response/certinfo/attestat/row Информация о типе аттестата
response/certinfo/attestat/row/@tid Тип аттестата <tid id="100">псевдонима</tid>
<tid id="110">формальный</tid>
<tid id="120">начальный</tid>
<tid id="130">персональный</tid>
<tid id="135">продавца</tid>
<tid id="136">capitaller</tid>
<tid id="140">разработчика</tid>
<tid id="150">регистратора</tid>
<tid id="170">гаранта</tid>
<tid id="190">сервиса wmt</tid>
<tid id="200">сервиса wmt</tid>
<tid id="300">оператора</tid>
response/certinfo/attestat/row/@recalled Информация об отказе в обслуживании Если значение атрибута равно 1, то владельцу данного аттестата отказано в обслуживании в системе
response/certinfo/attestat/row/@datecrt Дата и время (московское) выдачи аттестата
response/certinfo/attestat/row/@regnickname Название проекта, имя (nick) аттестатора, выдавшего данный аттестат
response/certinfo/attestat/row/@regwmid WMID аттестатора, выдавшего данный аттестат 12 цифр
response/certinfo/wmids/row Информация о всех WMID, прикрепленных к данному аттестату. Владельцы аттестатов, имеющих более одного WMID, могут задать уникальные для каждого характеристики (дополнительная информация и название (nick))
response/certinfo/wmids/row/@wmid WMID 12 цифр
response/certinfo/wmids/row/@info Дополнительная информация о WMID.
response/certinfo/wmids/row/@nickname Уникальное для данного WMID имя (nick)
response/certinfo/wmids/row/@datereg Дата и время (московское) регистрации WMID в системе В формате ГГГГ-ММ-ДДTЧЧ:ММ:СС.ССС
response/certinfo/wmids/row/@ctype Юридический статус WMID См. опорный словарь.
ctype =“1” – используется в интересах физического лица
ctype =“2” – используется в интересах юридического лица
response/certinfo/wmids/row/@companyname Название компании Заполняется только для юридических лиц.
response/certinfo/wmids/row/@companyid Регистрационный номер компании ИНН (для российских компаний) КОД ЕГРПОУ (для украинских), Certificate number и т.п. Заполняется только для юридических лиц.
response/certinfo/userinfo Персональные данные владельца аттестата, признаки проверки этих данных аттестатором и блокировки отображения персональных данных
response/certinfo/userinfo/value/row Персональные данные владельца аттестата.
response/certinfo/userinfo/value/row/@nickname Название проекта, имя (nick)
response/certinfo/userinfo/value/row/@infoopen Дополнительная информация (направление деятельности, комментарии, информация рекламного характера
response/certinfo/userinfo/value/row/@city Фактическое местонахождение (город) организации или владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@country Фактическое местонахождение (страна) организации или владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@zipcode Фактическое местонахождение (почтовый индекс) организации или владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@adres Фактическое местонахождение (адрес) организации или владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@fname Фамилия владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@iname Имя владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@oname Отчество владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@pnomer Номер паспорта владельца аттестованного идентификатора
response/certinfo/userinfo/value/row/@pdate Дата выдачи паспорта ММ/ДД/ГГГГ
response/certinfo/userinfo/value/row/@pcountry Место (страна) выдачи паспорта
response/certinfo/userinfo/value/row/@pcity Место (город) выдачи паспорта
response/certinfo/userinfo/value/row/@pbywhom Место (кем выдан) выдачи паспорта
response/certinfo/userinfo/value/row/@rcountry Место (страна) постоянной регистрации
response/certinfo/userinfo/value/row/@rcity Место (город) постоянной регистрации
response/certinfo/userinfo/value/row/@radres Место (полный адрес) постоянной регистрации
response/certinfo/userinfo/value/row/@bplace Место рождения (населенный пункт, страна)
response/certinfo/userinfo/value/row/@bday Дата рождения (день)
response/certinfo/userinfo/value/row/@bmonth Дата рождения (месяц)
response/certinfo/userinfo/value/row/@byear Дата рождения (год)
response/certinfo/userinfo/value/row/@icq Контактная информация владельца аттестованного идентификатора. UIN ICQ
response/certinfo/userinfo/value/row/@email Контактная информация владельца аттестованного идентификатора. Адрес электронной почты.
response/certinfo/userinfo/value/row/@web Контактная информация владельца аттестованного идентификатора. Адрес интернет сайта.
response/certinfo/userinfo/value/row/@phone Контактная информация владельца аттестованного идентификатора. Номер мобильного телефона.
response/certinfo/userinfo/value/row/@cap_owner Только для аттестатов Capitaller. WMID учредителя. 12 цифр
response/certinfo/userinfo/value/row/@pasdoc Признак проверки администратором центра аттестации электронной копии документа, удостоверяющего личность. Если pasdoc = 1, то электронная копия проверена администратором центра аттестации. Если pasdoc = 0, то электронная копия не проверена администратором центра аттестации.
response/certinfo/userinfo/value/row/@inndoc Признак проверки электронной копии свидетельства о постановке на налоговый учет администратором центра аттестации. Если inndoc = 1, то электронная копия проверена администратором центра аттестации. Если inndoc = 0, то электронная копия не проверена администратором центра аттестации.
response/certinfo/userinfo/check-lock/row Признак проверки персональных данных аттестатором и блокировки публичного отображения персональных данных. Атрибуты имеют имена, аналогичные тегам, описанным в блоке response/certinfo/userinfo/value/row
Атрибуты могут принимать следующие значения:
00 – данное поле не проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
01 – данное поле не проверено аттестатором и заблокировано владельцем аттестата для публичного показа
10 – данное поле проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
11 – данное поле проверено аттестатором и заблокировано владельцем аттестата для публичного показа
_Например: Если атрибут @fname=“10”, то Фамилия владельца аттестата проверена аттестатором, выдавшим аттестат. Данное поле доступно для публичного просмотра.

см. также XML-интерфейсы

Категория: XML-интерфейсы

This article in other languages: English