# Запрос на изменение параметров, добавление/удаление баз

## Запрос на изменение параметров, добавление/удаление баз

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/xml/bases.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 | Ваш логин в системе                                                                                                                                                      |
| bases.base<mark style="color:red;">\*</mark>     | String | Текст поздравления                                                                                                                                                       |
| token.value<mark style="color:red;">\*</mark>    | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру                                                                       |
| password.value<mark style="color:red;">\*</mark> | String | Ваш пароль в системе                                                                                                                                                     |
| delete\_bases.base.id\_base                      | String | Уникальный номер базы в системе, который необходимо удалить                                                                                                              |
| bases.base.on\_birth                             | String | <p>Включены ли поздравления:</p><p> - yes – включены </p><p> - no - выключены</p>                                                                                        |
| bases.base.originator\_birth                     | String | Отправитель поздравления                                                                                                                                                 |
| bases.base.local\_time\_birth                    | String | Считать время поздравления относительно местного времени абонента(**`yes`**) или относительно времени системы (**`no`**)                                                 |
| bases.base.time\_birth                           | Int    | Время поздравления                                                                                                                                                       |
| bases.base.name\_base                            | String | Название базы                                                                                                                                                            |
| bases.base.number\_base                          | Int    | Номер базы в XMLзапросе. Указывается только при создании новой базы. Используется для сопоставления IDдобавленных баз (если их было не сколько в запросе)                |
| bases.base.id\_base                              | Int    | <p>Уникальный номер базы в системе. </p><p><mark style="color:red;">! Если не указан произойдет добавление базы. При этом нужно указать параметр number\_base</mark></p> |

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

```xml
<?xml version="1.0" encoding="utf-8" ?>
<response>
     <base id_base=”1234”>edit</base>
     <base number_base=”1” id_base=”1235”>insert</ base>
     <base number_base=”2” id_base=”1236”>edit</ base>
     <base id_base=”1235”>delete</ base>
     <base id_base=”1235”>not_found</ base>
…
</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="185.33333333333331">Параметр</th><th width="153">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>base.id_base</td><td>Int</td><td>Уникальный номер базы в системе. </td></tr><tr><td>base.number_base</td><td>Int</td><td>Номер базы в XML запросе. Указывается только при создании новой базы. Используется для сопоставления ID добавленных баз (если их было не сколько в запросе)</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>
     <bases>
          <base id_base="1234" name_base="Базаглавногоофиса" time_birth="12:48" local_time_birth="yes" day_before="1" originator_birth="fitnes" on_birth="yes">Поздравляем!</base>
          <base number_base="1" name_base="БазаМосковскогоофиса" time_birth="12:48" local_time_birth="yes" day_before="1" originator_birth="fitnes" on_birth="yes">Поздравляем!</base>
     </bases>
     <delete_bases>
          <base id_base="1235" />
          <base id_base="1236" />
          …
     </delete_bases>
</request>
```