Получение списка абонентов базы

Спецификация для получения списка абонентов баз: XML

XML

Метод отправки POST

Кодировка XML-документов: UTF-8

Обязательный заголовок: Content-type: text/xml; charset=utf-8;

Адрес для запроса: https://my3.webcom.mobi/xml/list_phones.php

Параметры запроса на отправку сообщения

Параметр	Тип	Описание
request .security .login [value]*	String	Ваш логин в системе
request .security .password [value]*	String	Ваш пароль в системе
request .security .token [value]*	String	Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру
request .base [id_base]*	Int	Номер базы в системе
request .base [page]*	Int	Номер страницы. Весь список номеров базы делится на страницы. Запросить целиком базу нельзя. Можно лишь запросить отдельную страницу. Нумерация начинается с единички
request .base [last_update]	Date	Минимальная дата и время регистрации (или последнего изменения) данных абонента, которых Вам нужно запросить

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

В случае получения правильного XML-документа

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <phones page="1" num_pages="100">
          <phone phone="79612242243" region="Новосибирск" operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="m" addition_1="Первое дополнительное поле" addition_2="второе" last_update=” 2011-03-25 08:39:48” />
          <phone phone="79612242244" region="Новосибирск" operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="m" addition_1="Первое дополнительное поле" addition_2="второе" last_update=” 2011-03-25 08:39:48” />
          …
     </phones>
</response>

Параметр	Тип	Описание
response .phones [page]	Int	Номер страницы
response .phones [num_pages]	Int	Всего страниц
response .phones .phone [phone]	Int	Номер телефона абонента
response .phones .phone [region]	String	Регион
response .phones .phone [operator]	String	Оператор
response .phones .phone [name]	String	Имя абонента
response .phones .phone [surname]	String	Фамилия абонента
response .phones .phone [patronymic]	String	Отчество абонента
response .phones .phone [date_birth]	Date	Дата рождения
response .phones .phone [male]	String	Пол: «f»- женский «m» - мужской
response .phones .phone [addition_1]	String	Первое дополнительное поле
response .phones .phone [addition_2]	String	Второе дополнительное поле
response .phones .phone [last_update]	Date	Дата и время регистрации (или последнего изменения) данных абонента

В случае возникновения ошибки в отправленном XML-документе

<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>Текст ошибки</error>
</response>

Параметр	Тип	Описание
response .error	String	Текст ошибки может принимать следующие значения: Неправильный формат XML документа Ваш аккаунт заблокирован Неправильный логин или пароль POST данные отсутствуют

Пример XML запроса

<?xml  version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
    <base id_base="1234" page=”1” last_update=”2011-03-25 08:39:48”/>
</request>