Документация API Webcom Mobi
Search
⌃K
Comment on page

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

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