Документация API Webcom Mobi
  • Общая информация
  • История изменений
  • Отправка сообщения
  • Проверка статуса сообщения
    • POST запрос
    • Webhook
  • Проверка баланса
  • Регистрация
  • Получение списка отправителей
  • Добавление отправителей
  • Получение входящих сообщений
  • Получение информации по номеру телефона
  • Получение списка баз
  • Изменение параметров, добавление/удаление баз
  • Получение списка абонентов базы
  • Добавление/редактирование/удаление абонентов базы
  • Получение списка номеров из СТОП-листа
  • Добавление/удаление абонентов в СТОП-лист
  • Получение списка запланированных сообщений
  • Удаление запланированного сообщения
  • Получение времени изменения чего-либо
  • Проверка времени
  • Пополнение баланса пользователям
  • Загрузка файлов
  • Протокол SMPP v.3.4
    • Руководство по взаимодействию с сервисом
    • Спецификация
    • Описание статусов ошибок
Powered by GitBook

Получение входящих сообщений

Спецификация для получения входящих сообщений: XML

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

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

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

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

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

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

request

.security

.login

[value]*

String

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

request

.security

.password

[value]*

String

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

request

.security

.token

[value]*

String

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

request

.time

[start]*

Date

Время (не включительно), с которого запрашиваются входящие сообщения

request

.time

[end]

Date

Время (не включительно), по которое запрашиваются входящие сообщения.

Если не задан, то будут возвращены все смс

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <sms id_sms="1234" date_receive="2012-01-31 12:55:55" originator="79612242243" prefix="IGRA" phone="79611111111">Текст</sms>
     <sms id_sms="1234" date_receive="2012-01-31 12:55:55" originator="79612242243" prefix="IGRA" phone="79611111111">Текст</sms>
     …
</response>
Параметр
Тип
Описание

response

.sms

String

Входящее сообщение

response

.sms

[id_sms]

Int

Уникальный номер, состоящий только из цифр

response

.sms

[date_receive]

Date

Дата и время получения сообщения

response

.sms

[originator]

Int

Номер телефона абонента, отправившего

response

.sms

[prefix]

String

Префикс. Начальная часть текста SMS, по которой было определено, что эта SMS принадлежит именно этому клиенту. (Используется если один и тот же номер используется разными клиентами.)

response

.sms

[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>
    <time start="2012-01-31 12:23:00" end="2012-02-31 12:23:00" />
</request>

Last updated 1 year ago