Добавление/редактирование/удаление абонентов базы

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

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

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

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

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

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

Параметр
Тип
Описание

request

.security

.login

[value]*

String

Ваш логин в системе

request

.security

.password

[value]*

String

Ваш пароль в системе

request

.security

.token

[value]*

String

Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру

request

.base

[id_base]*

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

Второе дополнительное поле

sponse

.phones

.phone

[number_phone]

Int

Порядковый номер телефона в системе

sponse

.phones

.phone

[action]

String

В случае необходимости удаления "delete"

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <base id_base="1234">
          <phone phone="79612242243" number_phone="1"/>insert</phone>
          <phone phone="79612242244" number_phone="2" />edit</phone>
          <phone phone="79612242243" number_phone="5"/>delete</phone>
          <phone phone="79612242244" number_phone="6" />not_found</phone>
     </base>

</response>
Параметр
Тип
Описание

response

.base

[id_base]

Int

Номер базы в системе

response

.phones

.phone

String

Выполненное действие

response

.phones

.phone

[phone]

Int

Номер телефона абонента

response

.phones

.phone

[number_phone]

Int

Порядковый номер телефона в систем

В случае возникновения ошибки в отправленном 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">
          <phone phone="79612242243" region="Новосибирск" operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="мужской" addition_1="Первое дополнительное поле" addition_2="второе" number_phone="1"/>
          <phone phone="79612242244" region="Новосибирск" operator="Вымпелком" name="Константин" surname="Ермолаев" patronymic="Александрович" date_birth="1984-08-21" male="мужской" addition_1="Первое дополнительное поле" addition_2="второе" number_phone="2" />

          <phone phone="79612242243" action="delete" number_phone="5"/>
          <phone phone="79612242244" action="delete" number_phone="6"/>
     </base>
</request>

Last updated