<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 | отображение “опорного словаря” | В структуре возвращаемых некоторые значения заменяются специальным кодом (Например, тип аттестата персональный представляется цифрой 130 и т.п.). Словарь позволяет ознакомиться со всеми значениями и использовать их при работе с данным интерфейсом. Если 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=""> <directory> </directory> <attestat> <row cid="" regcid="" tid="" locked="" admlocked="" recalled="" datecrt="" regnickname="" regwmid=""/> </attestat> <wmids> <row wmid="" info="" nickname="" datereg=""/> </wmids> <userinfo> <value> <row ctype="" jstatus="" osnovainfo="" locked="" nickname="" infoopen="" city="" country="" zipcode="" adres="" fname="" iname="" oname="" pnomer="" pdate="" pcountry="" pcity="" pbywhom="" rcountry="" rcity="" radres="" bplace="" bday="" bmonth="" byear="" name="" dirfio="" buhfio="" inn="" okpo="" okonx="" jadres="" jcountry="" jcity="" jzipcode="" bankname="" bik="" ks="" rs="" phonehome="" phonemobile="" icq="" fax="" email="" web="" phone="" cap_owner="" pasdoc="" inndoc=""/> </value> <check-lock> <row jstatus="" osnovainfo="" nickname="" infoopen="" city="" country="" adres="" zipcode="" fname="" iname="" oname="" pnomer="" pdate="" pbywhom="" pcountry="" pcity="" rcountry="" rcity="" radres="" bplace="" bday="" name="" dirfio="" buhfio="" inn="" okpo="" okonx="" jadres="" jcountry="" jcity="" jzipcode="" bankname="" bik="" ks="" rs="" fax="" email="" web="" phone="" phonehome="" phonemobile="" icq=""/> </check-lock> </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 – юридический статус владельца аттестата (частое лицо или юридическое) jstatus – уточнение статуса для юридических лиц (директор, представитель и др.) tid – тип аттестата |
| response/certinfo/attestat/row | _ | Информация о всех выданных аттестатах. Тегов <row /> может быть несколько (по числу аттестатов). В этом случае первым идет блок с информацией о типе текущего аттестата. Для примера. Если на данный идентификатор в разное время были получены начальный и персональный аттестаты, то первым будет тег <row tid="130"> |
| response/certinfo/attestat/row/@cid | Внутренний номер владельца аттестата в системе центра аттестации (уникальный) | |
| response/certinfo/attestat/row/@regcid | Внутренний номер аттестатора в системе центра аттестации (уникальный) | |
| response/certinfo/attestat/row/@tid | Тип аттестата | См. опорный словарь При анализе данного параметра необходимо обратить внимание на атрибуты response/certinfo/attestat/row/ recalled или response/certinfo/userinfo/value/row/lockedЕсли их значение равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима. Проверять можно любой из атрибутов. |
| response/certinfo/attestat/row/@locked | Право выдачи аттестатов | Для владельцев персональных аттестатов наличие locked=0 означает наличие права выдачи начальных аттестатов, для владельцев аттестата регистратора наличие locked=0 означает наличие права выдачи персональных аттестатов. locked=1 означает временную блокировку выдачи аттестатов или отсутствие такого права. |
| response/certinfo/attestat/row/@admlocked | Право выдачи аттестатов | Для владельцев персональных аттестатов наличие admlocked=0 означает наличие права выдачи начальных аттестатов, для владельцев аттестата регистратора наличие admlocked=0 означает наличие права выдачи персональных аттестатов. admlocked=1 означает, что данный аттестатор лишен права выдачи аттестатов. |
| response/certinfo/attestat/row/@recalled | Информация об отзыве аттестата | Если значение атрибута равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима. Параметр аналогичен response/certinfo/userinfo/value/row/@locked |
| response/certinfo/attestat/row/@datecrt | Дата и время (московское) выдачи аттестата | |
| response/certinfo/attestat/row/@datediff | Разница в днях между текущей датой и датой выдачи аттестата | |
| 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/@yearreg | Год регистрации WMID в системе | В формате ГГГГ |
| response/certinfo/wmids/row/@monthreg | Месяц регистрации WMID в системе | От “1” до “12” |
| response/certinfo/wmids/row/@dayreg | День регистрации WMID в системе | От “1” до “31” |
| response/certinfo/wmids/row/@timereg | Время (московское) регистрации WMID в системе | В формате ЧЧ:ММ:СС |
| response/certinfo/userinfo | _ | Персональные данные владельца аттестата, признаки проверки этих данных аттестатором и блокировки отображения персональных данных |
| response/certinfo/userinfo/value/row | _ | Персональные данные владельца аттестата. |
| response/certinfo/userinfo/value/row/@ctype | Статус владельца | См. опорный словарь. ctype =“1” – Частное лицо ctype =“2” – Юридическое лицо |
| response/certinfo/userinfo/value/row/@jstatus | Для юридического лица. Статус (директор, представитель и др.) | См. опорный словарь. |
| response/certinfo/userinfo/value/row/@osnovainfo | Для юридического лица. На основании чего действует(устав, доверенность и др.) | |
| response/certinfo/userinfo/value/row/@locked | Информация об отзыве аттестата | * Если значение атрибута равно 1, то этот аттестат отозван и его статус эквивалентен аттестату псевдонима.* Параметр аналогичен response/certinfo/attestat/row/@recalled |
| 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/@name | Для юридического лица. Название организации | |
| response/certinfo/userinfo/value/row/@dirfio | Для юридического лица. Директор (ФИО) | |
| response/certinfo/userinfo/value/row/@buhfio | Для юридического лица. Гл. бухгалтер (ФИО) | |
| response/certinfo/userinfo/value/row/@inn | Для юридического лица. ИНН | |
| response/certinfo/userinfo/value/row/@okpo | Для юридического лица. ОКПО | |
| response/certinfo/userinfo/value/row/@okonx | Для юридического лица. ОКВЭД | |
| response/certinfo/userinfo/value/row/@jadres | Для юридического лица. Юридический адрес | |
| response/certinfo/userinfo/value/row/@jcountry | Для юридического лица. Юридический адрес (страна) | |
| response/certinfo/userinfo/value/row/@jcity | Для юридического лица. Юридический адрес (город) | |
| response/certinfo/userinfo/value/row/@jzipcode | Для юридического лица. Юридический адрес (почтовый индекс) | |
| response/certinfo/userinfo/value/row/@bankname | Для юридического лица. Банковские реквизиты. Название банка. | |
| response/certinfo/userinfo/value/row/@bik | Для юридического лица. Банковские реквизиты. БИК. | |
| response/certinfo/userinfo/value/row/@ks | Для юридического лица. Банковские реквизиты. Номер корреспондентского счета | |
| response/certinfo/userinfo/value/row/@rs | Для юридического лица. Банковские реквизиты. Номер расчетного счета | |
| response/certinfo/userinfo/value/row/@phonehome | Контактная информация владельца аттестованного идентификатора. Номер домашнего телефона. | |
| response/certinfo/userinfo/value/row/@phonemobile | Контактная информация владельца аттестованного идентификатора. Номер мобильного телефона. | |
| response/certinfo/userinfo/value/row/@icq | Контактная информация владельца аттестованного идентификатора. UIN ICQ | |
| response/certinfo/userinfo/value/row/@fax | Контактная информация владельца аттестованного идентификатора. Номер факса. | |
| 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