WebMoney

Wiki

Интерфейс X11

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

( доступ к информации из аттестата возможен также с использованием OAuth )
  • формат запроса:
<request>
    <wmid></wmid>
    <passportwmid></passportwmid>
    <sign></sign>
        <params>
            <dict></dict>
            <info></info>
            <mode></mode>
        </params>
</request>

  • параметры запроса:
название назначение примечание
wmid WM-идентификатор, подписавший запрос. Только WM Keeper WinPro (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 WinPro (Classic) в запросе необходимо лишь в случае если WMID, подписывающий запрос является доверенным идентификатором для проверяемого аттестата. Установка доверительных отношений производится на сайте центра аттестации. Доверенные WMID могут просматривать все персональные данные владельца аттестата, даже если их видимость была заблокирована владельцем аттестата. Оказание доверия является добровольной операцией, выполняемой владельцем аттестата, который при помощи специального интерфейса может вносить в список доверенных или удалить из него любой WMID.
Если доверительных отношений между проверяемым WMID и WMID, подписавшим запрос нет, то в запросе можно указать лишь параметр passportwmid. Структура запроса (наличие в нем всех описанных ранее тегов) должна быть неизменной в любом случае.

  • формат ответа:
<?xml version="1.0" encoding="windows-1251"?>
<response retval="">
<fullaccess></fullaccess>
    <certinfo wmid="">
        <attestat>
        <row tid="" recalled="" datecrt="" regnickname="" regwmid="" status="" notary=""/>
        </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 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=100 - аттестат псевдонима
tid=110 - формальный аттестат
tid=120 - начальный аттестат
tid=130 - персональный аттестат
tid=135 - аттестат продавца
tid=136 - аттестат capitaller, учрежденный группой физических лиц
tid=137 - аттестат capitaller, учрежденный юридическим лицом
tid=138 - аттестат расчетного автомата
tid=140 - аттестат разработчика
tid=150 - аттестат регистратора
tid=170 - аттестат гаранта
tid=190 - аттестат сервиса wmt
tid=200 - аттестат сервиса wmt
tid=300 - аттестат оператора
response/certinfo/attestat/row/@recalled Информация об отказе в обслуживании recalled=1 - владельцу данного аттестата отказано в обслуживании в системе
response/certinfo/attestat/row/@datecrt Дата и время (московское) выдачи аттестата В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/attestat/row/@dateupd Дата и время (московское) последнего изменения данных В формате гггг-мм-ддТчч:мм:сс.ммм
response/certinfo/attestat/row/@regnickname Название проекта, имя (nick) аттестатора, выдавшего данный аттестат
response/certinfo/attestat/row/@regwmid WMID аттестатора, выдавшего данный аттестат 12 цифр
response/certinfo/attestat/row/@status признак прохождения вторичной проверки только для начальных и выше аттестатов
10 - не пройдена
11 - пройдена
response/certinfo/attestat/row/@notary особенность получения аттестата только для начальных и выше аттестатов
0 - Аттестат выдан после личной встречи с аттестатором (устанавливается только после вторичной проверки)
1 - Аттестат выдан по нотариально заверенным документам (устанавливается только после вторичной проверки)
2 - Аттестат выдан автоматически, по результатам успешного пополнения кошелька (только начальные аттестаты)
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 Псевдоним (название проекта)
response/certinfo/wmids/row/@datereg Дата и время (московское) регистрации WMID в системе В формате гггг-мм-ддТчч:мм:сс.ммм
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 Название проекта, имя (nickname)
response/certinfo/userinfo/value/row/@country Почтовый адрес - страна
response/certinfo/userinfo/value/row/@city Почтовый адрес - город
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/@pdateend Дата окончания срока действия паспорта в формате мм/дд/гггг
response/certinfo/userinfo/value/row/@pcountry Государство, выдавшее паспорт
response/certinfo/userinfo/value/row/@pcountryid Код государства, выдавшее паспорт справочник кодов
response/certinfo/userinfo/value/row/@pbywhom Код или наименование подразделения (органа), выдавшего паспорт
response/certinfo/userinfo/value/row/@inn Персональный идентификатор для граждан Российской Федерации - ИНН
для граждан Украины - ИНН
для граждан Республики Беларусь - Идентификационный номер
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 - электронная копия сверена с персональными данными владельца WMID.
pasdoc=0 - электронная копия не сверена.
response/certinfo/userinfo/value/row/@regdoc Признак сверки администратором центра аттестации электронной копии страницы паспорта гражданина РФ с информацией о месте постоянной регистрации (регистрации по месту жительства). regdoc=1 - сверка с персональными данными владельца WMID произведена.
regdoc=0 - сверка не произведена.
response/certinfo/userinfo/value/row/@inndoc Признак сверки электронной копии свидетельства о постановке на налоговый учет гражданина РФ администратором центра аттестации. inndoc=1 - электронная копия сверена с персональными данными владельца WMID.
inndoc=0 - электронная копия не сверена.
response/certinfo/userinfo/value/row/@photoid Наличие у данного WMID проверенного PhotoID. photoid=1 - у данного WMID есть проверенный PhotoID.
photoid=0 - у данного WMID проверенного PhotoID нет.
response/certinfo/userinfo/value/row/@jabberid Jabber ID (JID)
response/certinfo/userinfo/value/row/@sex пол sex=0 - не установлен
sex=1 - мужской
sex=2 - женский
response/certinfo/userinfo/value/row/@infoopen Дополнительная информация (направление деятельности, комментарии, информация рекламного характера
response/certinfo/userinfo/check-lock/row Признак проверки персональных данных аттестатором и блокировки публичного отображения персональных данных. Атрибуты имеют имена, аналогичные тегам, описанным в блоке response/certinfo/userinfo/value/row
Атрибуты могут принимать следующие значения:
00 - данное поле не проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
01 - данное поле не проверено аттестатором и заблокировано владельцем аттестата для публичного показа
10 - данное поле проверено аттестатором и не заблокировано владельцем аттестата для публичного показа
11 - данное поле проверено аттестатором и заблокировано владельцем аттестата для публичного показа
Например: Если атрибут @fname="10", то Фамилия владельца аттестата проверена аттестатором, выдавшим аттестат. Данное поле доступно для публичного просмотра.

Доступ к информации предоставляемой интерфейсом возможен также с использованием OAuth

История изменений

26 мая 2015 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@pdateend - Дата окончания срока действия паспорта

19 июня 2014 года

Введен новый атрибут:
  • response/certinfo/userinfo/value/row/@pcountryid - Код государства, выдавшего паспорта (см. справочник кодов)
Упразднен атрибут:
  • response/certinfo/userinfo/value/row/@pcity - Место (город) выдачи паспорта

20 декабря 2013 года

Введены атрибуты:
  • response/certinfo/userinfo/value/row/@regdoc - Признак сверки администратором центра аттестации электронной копии страницы паспорта гражданина РФ с информацией о месте постоянной регистрации (регистрации по месту жительства)
  • response/certinfo/userinfo/value/row/@photoid - Наличие у данного WMID проверенного PhotoID

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