> For the complete documentation index, see [llms.txt](https://apidocs.webcom.mobi/ru2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.webcom.mobi/ru2/type/specifikaciya-xml/zapros-na-poluchenie-spiska-abonentov-bazy.md).

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

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

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/xml/list_phones.php`

#### Headers

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/xml; charset=utf-8;`** |

#### Request Body

| Name                                             | Type   | Description                                                                                                                                                           |
| ------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| login.value<mark style="color:red;">\*</mark>    | String | Ваш логин в системе                                                                                                                                                   |
| base.last\_update                                | Int    | Минимальная дата и время регистрации (или последнего изменения) данных абонента, которых Вам нужно запросить                                                          |
| base.page<mark style="color:red;">\*</mark>      | Int    | Номер страницы. Весь список номеров базы делится на страницы. Запросить целиком базу нельзя. Можно лишь запросить отдельную страницу. Нумерация начинается с единички |
| base.id\_base<mark style="color:red;">\*</mark>  | Int    | Номер базы в системе                                                                                                                                                  |
| token.value<mark style="color:red;">\*</mark>    | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру                                                                    |
| password.value<mark style="color:red;">\*</mark> | String | Ваш пароль в системе                                                                                                                                                  |

{% tabs %}
{% tab title="200: OK В случае получения правильного XML-документа" %}

```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>
```

{% endtab %}

{% tab title="400: Bad Request В случае возникновения ошибки в отправленном XML-документе" %}

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

{% endtab %}
{% endtabs %}

### Расшифровка параметров в ответах на запрос

<table><thead><tr><th width="167.33333333333331">Параметр</th><th width="154">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>phones.page</td><td>Int</td><td>Номер страницы</td></tr><tr><td>phones.num_pages</td><td>Int</td><td>Всего страниц</td></tr><tr><td>phones.phone.phone</td><td>Int</td><td>Номер телефона абонента</td></tr><tr><td>phones.phone.region</td><td>String</td><td>Регион</td></tr><tr><td>phones.phone.operator</td><td>String</td><td>Оператор</td></tr><tr><td>phones.phone.name</td><td>String</td><td>Имя абонента</td></tr><tr><td>phones.phone.surname</td><td>String</td><td>Фамилия абонента</td></tr><tr><td>phones.phone.patronymic</td><td>String</td><td>Отчество абонента</td></tr><tr><td>phones.phone.date_birth</td><td>Int</td><td>Дата рождения</td></tr><tr><td>phones.phone.male</td><td>String</td><td><p>Пол:</p><ul><li>«f»- женский</li><li>«m» - мужской </li></ul></td></tr><tr><td>phones.phone.addition_1</td><td>String</td><td>Первое дополнительное поле</td></tr><tr><td>phones.phone.addition_2</td><td>String</td><td>Второе дополнительное поле</td></tr><tr><td>phones.phone.last_update</td><td>Int</td><td>Дата и время регистрации (или последнего изменения) данных абонента</td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul></td></tr></tbody></table>

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

```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>
```