Тарифи	Послуги	API	Партнерам	Про сервіс	Контакти

^{Безкоштовно по Україні}

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

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

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

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

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

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

Приклади надсилання повідомлень

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

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

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

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

Приклади відправки e-mail повідомлень

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

Використання голосового меню (IVR)

Приклади відправки голосових повідомлень

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

Передача файлів

Додавання кнопки

Типи повідомлень

Приклади відправки viber-повідомлень

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

Приклади відправки повідомлень в Telegram

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

Приклади відправки повідомлень в чат-бот Telegram

Надсилання повідомлення на Whatsapp

Приклади відправки повідомлень в Whatsapp

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

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

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

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

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

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

Дії з розсилками

Розсилання. Відповідь сервера та коди помилок

Приклади операцій з розсилками

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

Перевірка статусу

Статуси повідомлень. Відповідь сервера та коди помилок

Коди статусів

Коди помилок у статусі

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

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

Запит балансу

Баланс. Відповідь сервера та коди помилок

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

Дії з контактами і групами

Контакти та групи. Опис параметрів

Контакти та групи. Відповідь сервера та коди помилок

Приклади операцій з контактами

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

Робота із субклієнтами

Перелік доступних операцій

Субклієнти. Опис параметрів

Відповідь сервера і коди помилок (субклієнти)

Приклади дій із субклієнтами

Створення і вивантаження рахунків і актів

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

Перелік доступних операцій з іменами відправників

Опис параметрів

Відповідь сервера і коди помилок (імена відправників)

Приклади дій з іменами відправників

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

Отримання історії відправлених повідомлень

Отримання вхідних повідомлень

Отримання статистики

Запит тарифів

Отримання інформації про оператора

Отримання даних о короткому посиланні

РІЗНЕ

Підключення виділених номерів для прийому повідомлень

Передача статусів і повідомлень на обробник Клієнта

Підключення антиспам перевірки (captcha) до сайту

Підтвердження номеру телефону за допомогою дзвінка

Дії з відкладеними завданнями

Отримання інформації про оператора

Для отримання інформації про оператора абонента (крім портованих номерів) необхідно викликати методом GET або POST адресу:


https://smsc.ua/sys/info.php?get_operator=1&login=<login>&psw=<password>&phone=<phone>

Опис параметрів, що передаються Серверу:

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

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

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

При успішному запиті Сервер повертає відповідь у вигляді рядка або списку рядків при множиному запиті (у цьому випадку у відповідь Сервера додається параметр "phone"):

при fmt = 0: country = <country>, operator = <operator>, region = <region>, mcc = <mcc>, mnc = <mnc>, tz = <tz>
при fmt = 1: <country>,<operator>,<region>,<mcc>,<mnc>,<tz>
при fmt = 2:
<info>
<country>country</country>
<operator>operator</operator>
<region>region</region>
<mcc>mcc</mcc>
<mnc>mnc</mnc>
<tz>tz</tz>
</info>

При множинному запиті конструкції <info> заключаються в тег <list>.
при fmt = 3:
{
"country": "<country>",
"operator": "<operator>",
"region": "<region>",
"mcc": "<mcc>",
"mnc": "<mnc>",
"tz": "<tz>"
}

Де:
<phone> – номер телефону абонента.
<country> – назва країни реєстрації номера абонента.
<operator> – мобільний оператор абонента.
<region> – регіон реєстрації номера абонента.
<mcc> – числовий код країни абонента.
<mnc> – числовий код оператора абонента.
<tz> – часовий пояс регіону реєстрації номера абонента.

Приклад:

Отримання інформації про оператора абонента з номером "79999999999":

https://smsc.ua/sys/info.php?get_operator=1&login=alex&psw=123&phone=79999999999

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

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

Увійти через:


Запам'ятати для автовходу



Реєстрація	Забули пароль?