<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