Тарифи  Послуги  API  Партнерам  Про сервіс  Контакти 
0 (800) 30 7672
Безкоштовно по Україні
 

Інтеграція з сервісом (API)

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


HTTP/HTTPS SMTP SMPP SOAP OMS SMS-команды Бібліотеки і приклади коду

ВІДПРАВКА ПОВІДОМЛЕНЬ

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

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

Відправка на групу номерів

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

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

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

Відправка голосового повідомлення (дзвінок)

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

Використання префіксів при відправці повідомлень

Управління шаблонами повідомлень

Керування шаблонами операторів

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

Повідомлення про події

УПРАВЛІННЯ РОЗСИЛКАМИ

СТАТУСИ ПОВІДОМЛЕНЬ

ПЕРЕВІРКА СТАНУ БАЛАНСУ

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

УПРАВЛІННЯ КЛІЄНТАМИ

УПРАВЛІННЯ ІМЕНАМИ ВІДПРАВНИКІВ (SENDER ID)

ОТРИМАННЯ ДАНИХ

РІЗНЕ

Керування шаблонами операторів

Для управления шаблонами сервисных и транзакционных сообщений необходимо вызвать методом GET или POST соответствующий адрес с указанием требуемой команды и параметров.

Для створення шаблону (для всіх операторів): https://smsc.ua/sys/op_templates.php?add=1&login=<login>&psw=<password>&sender=<sender>&msg=<msg>&mts_srv=1&mts_trn=1&mega_srv=1&mega_trn=1&bee_srv=1&bee_trn=1&tele2_srv=1&tele2_trn=1
Для отримання інформації про шаблон (по всіх операторах): https://smsc.ua/sys/op_templates.php?get=1&login=<login>&psw=<password>&sender=<sender>&msg=<msg>
Сервера передаються наступні параметри:

ПараметрЗначення
loginЛогін Клієнта.
pswПароль Клієнта (можно добавить или изменить на данной странице).
senderІм'я відправника для якого створюється шаблон.
msgТекст шаблону.
charsetКодировка текста шаблона, если используется отличная от кодировки по умолчанию windows-1251. Варианты: utf-8 и koi8-r.
mts_srvСтворити шаблон для оператора МТС (сервісні повідомлення).
mts_trnСтворити шаблон для оператора МТС (транзакційні повідомлення).
mega_srvСтворити шаблон для оператора Мегафон (сервісні повідомлення).
mega_trnСтворити шаблон для оператора Мегафон (транзакційні повідомлення).
bee_srvСтворити шаблон для оператора Білайн (сервісні повідомлення).
bee_trnСтворити шаблон для оператора Білайн (транзакційні повідомлення).
tele2_srvСтворити шаблон для оператора Теле2 (сервісні повідомлення).
tele2_trnСтворити шаблон для оператора Теле2 (транзакційні повідомлення).

У разі помилки Сервер повертає наступний рядок:
  • при fmt = 0:
    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Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (якщо такий список був налаштований Клієнтом раніше).
4IP-адрес временно заблокирован.
9Спроба відправки більше десяти однакових запитів на дії з шаблонами.
Дана помилка виникає також при спробі відправки п'ятнадцяти і більше запитів одночасно з різних підключень під одним логіном (too many concurrent requests).

У разі успішного запиту Сервер повертає відповідь у вигляді рядка:

При створенні шаблону:
  • при fmt = 0:
    name = <status>, id = <id>
    ...

  • при fmt = 1:
    <name>,<status>,<id>
    ...

  • при fmt = 2:
    <result>
    <template>
    <name>name</name>
    <status>status</status>
    <id>id</id>
    </template>
    ...
    </result>

  • при fmt = 3:
    [{
    "name": <status>,
    "id": <id>
    },
    ...]

При запиті списку шаблонів:
  • при fmt = 0:
    name = <status>, id = <id>
    ...

  • при fmt = 1:
    <name>,<status>,<id>
    ...

  • при fmt = 2:
    <result>
    <template>
    <name>name</name>
    <status>status</status>
    <id>id</id>
    </template>
    ...
    </result>

  • при fmt = 3:
    [{
    "name": <status>,
    "id": <id>
    },
    ...]

Де:
<name> – назва оператора і тип повідомлень.
<id> – ідентифікатор шаблону, призначений системою автоматично.
<status> – статус шаблону, може набувати таких значень:

для команды add:
-2 – неможливо зберегти вказаний шаблон;
-1 – ім'я відправника для даного шаблону, не знайдено або не прийнято оператором;
1 – шаблон успішно доданий;

для команды get:
-1 – шаблон для зазначеного оператора не знайдено;
0 – очікує реєстрації;
1 – відправлено на реєстрацію;
2 – допущено оператором;
3 – не прийнято оператором;
4 – тимчасово вимкнено.

Сервер не приймає більше десяти однакових запитів на дії з шаблонами протягом хвилини для зниження навантаження і захисту від помилок і зациклення в програмі на стороні Клієнта.




© 2003–2021 ТОВ «СМСЦЕНТР»
Код за ЄДРПОУ 38404962
support@smsc.ua
Контакти
Дизайн — Студия Артемия Лебедева
Інформація про сайт
Яндекс.Метрика