Тарифи  Послуги  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/downloads.php?login=<login>&psw=<password>&get_list=1
Для отримання файлу завдання з відправленими повідомленнями необхідно викликати методом GET або POST адресу: https://smsc.ua/sys/downloads.php?login=<login>&psw=<password>&get_file=1&id=<id> або https://smsc.ua/sys/downloads.php?login=<login>&psw=<password>&get_file=1&name=<name>
Серверу передаються наступні параметри:

ПараметрЗначення
loginЛогін Клієнта.
pswПароль Клієнта (можна додати або редагувати на даннійсторінці).
apikeyСпеціальний API-ключ, який використовується для спрощеної авторизації замість пари "логін + пароль" (можна створити на даний сторінка).
cntКількість відкладених завдань, що повертаються Сервером.
after_idДаний параметр вказує Серверу на необхідність повернення у відповіді списку завдань з ідентифікаторами, наступними за after_id.
idЗавантажити файл завдання з ідентифікатором, рівним id.
nameЗавантажити файл завдання з ім'ям name.

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

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

При отриманні списку відкладених завдань:
  • при fmt = 0: id = <id>, name = <name>, status = <status>, created = <created>, time = <time>, file = <file>

  • при fmt = 1: <id>,<name>,<status>,<created>,<time>,<file>

  • при fmt = 2:
    <list>
    <task>
    <id>id</id>
    <name>name</name>
    <status>status</status>
    <created>created</created>
    <time>time</time>
    <file>file</file>
    </task>
    ...
    </list>

  • при fmt = 3:
    [{ "id": id,
    "name": "name",
    "status": "status",
    "created": "created",
    "time": "time",
    "file": "file"
    },
    ...]

Де:
<id> – ідентифікатор відкладеного завдання.
<name> – назва завдання.
<status> – статус завдання (0-очікує виконання, 1-виконується, 2-виконано, 3-скасовано, 4-помилка виконання).
<created> – дата створення завдання.
<time> – час запуску завдання.
<file> – назва файлу завдання.

Після присвоєння відкладеному завданням статусу 2 (виконано) з'явиться можливість завантажити файл з пакетом відправлених повідомлень у форматі csv.

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




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