| Правильная ссылка на эту статью: |
Интерфейс импорта данных сервиса 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>