API / HTTP/HTTPS протокол / -Выгрузка портированных номеров

API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.



ОТПРАВКА СООБЩЕНИЙ

Отправка SMS-сообщения

Комментарии в SMS-сообщениях

Отправка на группу номеров

Отправка HLR-запроса

Отправка MMS-сообщения

Отправка e-mail сообщения

Отправка голосового сообщения (звонок)

Отправка viber-сообщения

Использование префиксов при отправке сообщений

Управление шаблонами сообщений

Управление шаблонами операторов

Виртуальная отправка (режим тестирования)

Уведомления о событиях

УПРАВЛЕНИЕ РАССЫЛКАМИ

СТАТУСЫ СООБЩЕНИЙ

ПРОВЕРКА СОСТОЯНИЯ БАЛАНСА

УПРАВЛЕНИЕ КОНТАКТАМИ

УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)

ПОЛУЧЕНИЕ ДАННЫХ

РАЗНОЕ

-Выгрузка портированных номеров

Для выгрузки полной базы портированных номеров необходимо вызвать методом GET или POST адрес: http://my.smscab.ru/sys/get_mnp.php?login=<login>&psw=<password>
Для выгрузки ежедневных обновлений базы портированных номеров необходимо вызвать методом GET или POST адрес: http://my.smscab.ru/sys/get_mnp.php?login=<login>&psw=<password>&date=<date>
Описание параметров, передаваемых Серверу:

ПараметрЗначение
loginЛогин Клиента.
pswПароль Клиента (можно добавить или изменить на данной странице).
dateДата, начиная с которой необходимо выгрузить портированные номера. Формат: 'дд.мм.гггг' или unix timestamp. Возможно указание даты не ранее 7 дней от текущей. Если не указывать, то выгрузится полный список в виде csv-файла mnp_list.csv с форматом строк: "телефон;mccmnc".
mccКод страны (например, Россия – 250).

В случае ошибки Сервер возвращает следующую строку:
  • ERROR = N (описание)

  • При fmt = 1:
    0,-N

  • При fmt = 2:
    <result>
    <error>описание</error>
    <error_code>N</error_code>
    </result>

  • При fmt = 3:
    {
    "error": "описание",
    "error_code": N
    }
N – номер ошибки, может принимать следующие значения:

ЗначениеОписание
1Ошибка в параметрах.
2Неверный логин или пароль.
4IP-адрес временно заблокирован.
9Попытка отправки более трех одинаковых запросов на выгрузку базы портированных номеров в течение минуты.
Данная ошибка возникает также при попытке отправки более 15 любых запросов одновременно.

В случае успешного запроса Сервер возвращает ответ в виде строки:
  • при fmt = 0:
    phone = <phone>, mcc = <mcc>, mnc = <mnc>
    ...

  • при fmt = 1:
    <phone>,<mccmnc>
    ...

  • при fmt = 2:
    <phones>
    <phone mcc="<mcc>" mnc="<mnc>"></phone>
    ...
    </phones>

  • при fmt = 3:
    [{
    "phone": "<phone>",
    "mcc": <mcc>,
    "mnc": <mnc>
    },
    ...]

  • при любом fmt и без параметра date:
    Phone;mccmnc
    <phone>;<mccmnc>
    <phone>;<mccmnc>
    ...

Где:
<phone> - телефон абонента.
<mcc> - mcc код страны.
<mnc> - mnc код оператора. Значение, равное 0 указывает на то, что абонент вернулся к родному оператору.
<mccmnc> - код страны и код оператора вместе. Если mnc равно 0 – значит абонент вернулся к родному оператору.

Примеры:

Выгрузка портированных номеров начиная с "20.09.2014":

http://my.smscab.ru/sys/get_mnp.php?login=alex&psw=123&date=20.09.2014

Сервер не принимает более трех одинаковых запросов в течение минуты на выгрузку базы портированных номеров для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.