Тарифи  Послуги  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/templates.php?add=1&login=<login>&psw=<password>&name=<name>&msg=<msg>
Для зміни шаблону: https://smsc.ua/sys/templates.php?chg=1&login=<login>&psw=<password>&id=<id>
Для видалення шаблону: https://smsc.ua/sys/templates.php?del=1&login=<login>&psw=<password>&id=<id>
Для отримання списку шаблонів: https://smsc.ua/sys/templates.php?get=1&login=<login>&psw=<password>
Серверу передаються наступні параметри:

ПараметрЗначення
loginЛогін Клієнта.
pswПароль Клієнта (можна додати або редагувати на даннійсторінці).
nameНазва шаблона.
msgТекст повідомлення.
formatФормат повідомлення:
порожній рядок - не заданий.
sms – SMS-повідомлення.
flash – Flash-SMS.
bin – Бінарне SMS.
push – Wap-push.
mms – MMS.
call – Дзвінок.
mail – E-mail.
viber – Viber.
senderІм'я відправника.
fl[1]Використовувати для автопідпису.

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

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

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

  • при fmt = 1: <id>

  • при fmt = 2:
    <template>
    <id>id</id>
    </template>

  • при fmt = 3:
    {
    "id": <id>
    }

При зміні або видаленні шаблону:
  • при fmt = 0, 1: OK

  • при fmt = 2:
    <result>OK</result>

  • при fmt = 3:
    {
    "result": "OK"
    }


При запиті списку шаблонів повідомлень:
  • при fmt = 0:
    id = <id>, name = <name>, format = <format>, sender = <sender>, flag = <flag>, message = <message>
    ...

  • при fmt = 1:
    <id>,<name>,<format>,<sender>,<flag>,<message>
    ...

  • при fmt = 2:
    <list>
    <template>
    <id>id</id>
    <name>name</name>
    <format>format</format>
    <sender>sender</sender>
    <flag>flag</flag>
    <message>message</message>
    </template>
    ...
    </list>

  • при fmt = 3:
    [{
    "id": <id>,
    "name": "<name>",
    "format": "<format>",
    "sender": "<sender>",
    "flag": <flag>,
    "message": "<message>"
    },
    ...]

Де:
<id> – ідентифікатор шаблону, призначений системою автоматично.
<name> – назва шаблона.
<format> – формат повідомлення.
<sender> – ім'я відправника.
<flag> – прапор для шаблону. Установка першого біта прапора (fl[1]=1) призначає використання шаблону для автопідпису.
<message> – текст повідомлення.

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




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