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

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

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>