Как получить информацию из базы данных?

Данный сервис работает на основе POST XML запросов по протоколу HTTP. XML запрос следует направлять по адресу: http://locator.internet-transfer.com/proto.html в POST-переменной data.

База данных содержит следующие данные: список стран, список городов, список станций метро, список терминалов. В связи с огромным количеством данных в основном списке терминалов и упреждении нагрузки на сервер, получить список терминалов возможно только уточнив город. Т.е. в запросе для получения списка терминалов обязательно должен быть указан идентификатор города из списка городов. Список городов можно обновлять не чаще 1 раза в неделю.

Описание протокола / XML-запросов

Для того, что бы получить данные списка (например, список городов), необходимо сформировать запрос следующего вида: <?xml version="1.0" ?>
<xmlDoc>
  <header>
    <function>URQ_GET_LIST</function>
  </header>
  <request>
    <param name="name">dic_city</param>
    <param name="dic_country_id">1</param>
  </request>
</xmlDoc>

Данный запрос является типовым. В случае получения данных других списков, менятся будет только параметры запроса xmlDoc-request-param.

  • dic_country - список стран. Данный список не содержит дополнительных параметров;

  • dic_city - список городов. Дополнительный параметр: dic_country_id* - идентификатор страны;

  • dic_city_subway_station - станции метро. Дополнительный параметр: dic_city_id* - идентификатор города;

  • dic_point - список терминалов; Дополнительный параметр: dic_city_id* - идентификатор города, dic_city_subway_station - идентификатор станции метро.

* - обязательные параметры.

Для всех списов за исключением списка терминалов, ответ будет так же типовым (например, список городов): <?xml version="1.0" ?>
<xmlDoc>
  <header>
    <function>URQ_GET_LIST</function>
  </header>
  <response>
    <item id="1">Санкт-Петербург*</item>
    <item id="2">Москва*</item>
  </response>
</xmlDoc>

* - возвращаемые значения будут в формате base64.

Для списка терминалов, ответ сервера будет выглядеть следующим образом: <?xml version="1.0" ?>
<xmlDoc>
  <header>
    <function>URQ_GET_LIST</function>
  </header>
  <response>
    <item>
         <type>Терминал по приему платежей*</type>
         <dic_city_id>1</dic_city_id>
         <dic_city_subway_station_id>1</dic_city_subway_station_id>
         <address>Загородная улица, дом 1 (магазин ПРОДУКТЫ)*</address>
         <description>рядом с кассами*</description>
         <worktime>с 10:00 до 22:00 (время работы магазина)*</worktime>
         <comission>3%</comission>
         <latitude>0.000000</latitude>
         <longitude>0.000000</longitude>
         <hash>819702b90bdbf93a2d2b0ce140dd3aca</hash>
    </item>
  </response>
</xmlDoc>

* - возвращаемые значения будут в формате base64.

Пример работы протокола на языке PHP вы можете запросить по адресу:

© 2008, ООО «ИНТЕРНЕТ-ТРАНСФЕР»