Документация 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/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 modified 3mo ago