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

Спецификация для получения списка абонентов баз: 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>

Last updated