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

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

API дозволяє розсилати повідомлення через ваші проекти і сервіси по протоколах HTTP/HTTPS, SMTP і SMPP. Готові бібліотеки різними мовами програмування підключаються до вашого проекту та допомагають надсилати повідомлення з будь-якого місця за допомогою однієї команди. Для спрощеної авторизації замість пари логін і пароль можна використовувати спеціальний API-ключ.
HTTP/HTTPS SMTP SMPP SOAP OMS SMS-команди Бібліотеки та приклади коду

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

Відправка SMS-повідомлення

Коментарі в SMS-повідомленнях

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

Відправка HLR-запиту

Відправка e-mail повідомлення

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

Відправка viber-повідомлення

Відправлення повідомлення в Telegram

Відправлення повідомлення в чат-бот Telegram

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

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

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

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

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

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

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

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

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

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

КЕРУВАННЯ ІМЕНАМИ ВІДПРАВНИКІВ (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_auth=1&mts_trn=1&mega_srv=1&mega_auth=1&mega_trn=1&mega_adv=1&bee_srv=1&bee_trn=1&tele2_srv=1&tele2_trn=1&motiv_srv=1&motiv_trn=1&soc=1
Для отримання інформації про шаблон (по всіх операторах): https://smsc.ua/sys/op_templates.php?get=1&login=<login>&psw=<password>&sender=<sender>&msg=<msg>
Серверу передаються наступні параметри:

ПараметрЗначення
loginЛогін Клієнта.
pswПароль Клієнта (можна додати або редагувати на даннійсторінці).
apikeyСпеціальний API-ключ, який використовується для спрощеної авторизації замість пари "логін + пароль" (можна створити на даний сторінка).
senderІм'я відправника для якого створюється шаблон.
msgТекст шаблону.
charsetКодування тексту шаблону, якщо використовується відмінна від кодування за замовчуванням windows-1251. Варіанти: utf-8 і koi8-r.
mts_srvСтворити шаблон для оператора МТС (сервісні повідомлення).
mts_authСтворити шаблон для оператора МТС (авторизаційні повідомлення).
mts_trnСтворити шаблон для оператора МТС (транзакційні повідомлення).
mega_advСтворити шаблон для оператора Мегафон (рекламні шаблоновані повідомлення).
mega_srvСтворити шаблон для оператора Мегафон (Сервісні (інформаційні) повідомлення).
mega_authСтворити шаблон для оператора Мегафон (авторизаційні повідомлення).
mega_trnСтворити шаблон для оператора Мегафон (транзакційні повідомлення).
bee_srvСтворити шаблон для оператора Білайн (сервісні повідомлення).
bee_trnСтворити шаблон для оператора Білайн (транзакційні повідомлення).
tele2_srvСтворити шаблон для оператора Теле2 (сервісні повідомлення).
tele2_trnСтворити шаблон для оператора Теле2 (транзакційні повідомлення).
motiv_srvСтворити шаблон для оператора МОТИВ (сервісні повідомлення).
motiv_trnСтворити шаблон для оператора МОТИВ (транзакційні повідомлення).
socСтворити шаблон для soc-повідомлення, що відправляється користувачам соціальних мереж "Однокласники"," ВКонтакті " або користувачам "Mail.Ru Агент".

У разі помилки Сервер повертає наступний рядок:
  • при 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–2024 ТОВ " СМСЦЕНТР»
Код ЄДРПОУ 38404962 		support@smsc.ua
Контакти 		Дизайн — Студія Артемія Лебедєва
Інформація про сайт 		SMS-центр для Android Яндекс.Метрика