Правильная ссылка на эту статью: |
Интерфейс импорта данных сервиса Geo WebMoney
Данный интерфейс позволяет производить автоматическую загрузку на сервер WebMoney GeoService списка пользовательских WM-объектов определенного типа.
Формат файла XML для сервиса:¶
Ниже приведен пример, описывающий один пользовательский объект (обменный пункт)
<?xml version="1.0" encoding="windows-1251"?> <wmobjects> <row sid="34" citid="12918" name="Обменный пункт WM-USD (через банковскую ячейку)" wmid="254923317046" web="http://www.wmcasher.com" email="cash@wmcasher.com" type="1" addr="ул. Орджоникидзе д.9 корп.2" worktime="Понедельник - пятница, с 11:00 до 17:00" phone="(смотрите на сайте)" mid="69" mid2="158" dopinfo="Обмен WM на наличные USD и наоборот через банковскую ячейку. Ввод - 0%, вывод - 2%" help="http://www.wmcasher.com/contact.asp" lng="37.5998" lat="55.70924" direction="3" lang="ru-RU" /> </wmobjects>
Требования к файлу:¶
- Файл должен начинаться открывающим тэгом <wmobjects> и заканчиваться тэгом </wmobjects>
- Содержать хотя бы один тег <row/> - строка, содержащая данные об одном объекте
- Файл должен быть сохранен в кодировке windows-1251
- Все объекты должны быть географически привязаны к базе данных WebMoney GeoService, т.е. каждому объекту должен быть сопоставлен уникальный номер (ID) населенного пункта, в котором он расположен. Как получить список стран, регионов и городов, читайте ниже по тексту.
- Ко всем данным должно применяться маскирование запрещенных символов:
- Двойные кавычки «"» должны быть замены на "
- Знак Больше «>» должен быть заменен на >
- Знак Меньше «<» должен быть заменен на <
Название атрибута XML | Обязательный | Описание параметра |
wmobjects/row/@sid | Обязательный | Уникальный номер точки или уникальный идентификатор автомата, банкомата или терминала (kiosk_id). |
wmobjects/row/@citid | Обязательный | Номер (ID) города, в котором расположен объект. ID городов можно найти здесь |
wmobjects/row/@name | Обязательный | Название объекта |
wmobjects/row/@type | Обязательный | Тип объекта (6 - точки продажи WM карт, 7 - точки пополнения наличными, остальные необходимо согласовать с администратором сервиса (geosupport@webmoney.ru) |
wmobjects/row/@lang | Обязательный | Язык (CultureInfo) |
wmobjects/row/@direction | Обязательный | Тип услуги (1-ввод, 2-вывод, 3-ввод/вывод) |
wmobjects/row/@country | Необязательный | Страна |
wmobjects/row/@region | Необязательный | Регион |
wmobjects/row/@city | Необязательный | Город |
wmobjects/row/@wmid | Необязательный | WM - идентификатор |
wmobjects/row/@web | Необязательный | URL сайта |
wmobjects/row/@email | Необязательный | |
wmobjects/row/@mid | Обязательный для объектов в Москве и Санкт-Петербурге | Номер (ID) ближайшей станции метро (1). Только для Москвы и Санкт-Петербурга ID станций метро можно найти здесь |
wmobjects/row/@mid2 | Необязательный | Номер (ID) ближайшей станции метро (2). Только для Москвы и Санкт-Петербурга ID станций метро можно найти здесь |
wmobjects/row/@dopinfo | Необязательный | Дополнительная информация |
wmobjects/row/@phone | Необязательный | Номер контактного телефона |
wmobjects/row/@addr | Необязательный | Адрес |
wmobjects/row/@worktime | Необязательный | Рабочие часы |
wmobjects/row/@tarif | Необязательный | Тариф |
wmobjects/row/@proezd | Необязательный | Схема проезда (URL) |
wmobjects/row/@srok | Необязательный | Срок пополнения |
wmobjects/row/@help | Необязательный | Инструкция (URL) |
wmobjects/row/@lng | Необязательный | Долгота (Longitude) |
wmobjects/row/@lat | Необязательный | Широта (Latitude) |
Каждый пакет XML не должен превышать 200 (максимальное число строк) строк в одном наборе данных. Для обновления данных, где количество строк больше чем 200, сервис обновления сайта вызывает зарегистрированный URL несколько раз, с различными параметрами FirstId, который указывает на максимальный SID предыдущего набора данных. Для корректной работы системы обновления в каждом пакете данных (оптимально использовать не более 200 строк) необходимо указывать тег LastID. LastID - это максимальный SID (идентификатор точки) в одном наборе данных.
Формат описан ниже:
http://yoursite.com/yourservice/dataxml?fisrtid=0 (lastid будет равен 200) http://yoursite.com/yourservice/dataxml?fisrtid=200 (lastid будет равен 400) http://yoursite.com/yourservice/dataxml?fisrtid=400 (lastid будет равен 600) . . . http://yoursite.com/yourservice/dataxml?fisrtid=1000 (lastid будет равен 1200) http://yoursite.com/yourservice/dataxml?fisrtid=1200 (lastid не больше чем 1200 или -1, данные кончились)
Название тега XML | Обязательный | Описание параметра |
wmobjects/lastid/@value | Обязательный, если общий объем данных превышает количество 200 строк | Идентификатор последней записи в наборе данных |
Пример для банков и платежных систем, принимающих наличные рубли для пополнения R-кошельков системы WebMoney Transfer:¶
<?xml version="1.0" encoding="windows-1251"?> <wmobjects> <row sid="1000" citid="12918" name="Платежный терминал X-System" web="http://www.x-system.ru/" email="support@x-system.ru" mid="117" addr="ул. Квесисская, д. 28, стр. 11." srok="мгновенно" tarif="2.5% от суммы платежа" worktime="круглосуточно" help="http://www.webmoney.ru/wmintrans6.shtml" dopinfo="Пополнение R кошелька наличными рублями" direction="1" type="7"/> <row sid="1001" citid="28610" name="Платежный терминал X-System" web="http://www.x-system.ru/" email="support@x-system.ru" mid="1001" addr="ул. Коллонтай, д. 23, стр. 2." srok="мгновенно" tarif="2.5% от суммы платежа" worktime="круглосуточно" help="http://www.webmoney.ru/wmintrans6.shtml" dopinfo="Пополнение R кошелька наличными рублями" direction="1" type="7"/> . . . <row sid="1200" citid="12918" name="Платежный терминал X-System" web="http://www.x-system.ru/" email="support@x-system.ru" mid="13" addr="ул. Римского-Корсакова, д. 22" srok="с 9-00 до 22-00" tarif="2.5% от суммы платежа" worktime="круглосуточно" help="http://www.webmoney.ru/wmintrans6.shtml" dopinfo="Пополнение R кошелька наличными рублями" direction="1" type="7"/> <lastid value="-1" /> <!-- конец данных --> </wmobjects>