Тарифи	Послуги	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/get.php?get_price=1&login=<login>&psw=<password>

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

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

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

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

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

при fmt = 0:
zone = <zone>, name = <name>, api = <api>, mass = <mass>, mms = <mms>, hlr = <hlr>, call = <call>
...

при наявності встановлених індивідуальних тарифів за певними операторами до відповіді додається набір рядків:

mccmnc = <mccmnc>, cost = <cost>
...

mail = <mail>
при fmt = 1:
<zone>,<name>,<api>,<mass>,<mms>,<hlr>,<call>
...

<mccmnc>,<cost>
...

<mail>

при fmt = 2:

<price>
<zones>
<zone name="<name>" api="<api>" mass="<mass>" mms="<mms>" hlr="<hlr>" call="<call>">zone</zone>
...
</zones>
<codes>
<mccmnc cost="<cost>">mccmnc</mccmnc>
...
</codes>
<mail>mail</mail>
</price>

при fmt = 3:

{
"zones": [{
"zone": "<zone>",
"name": "<name>",
"api": "<api>",
"mass": "<mass>",
"mms": "<mms>",
"hlr": "<hlr>",
"call": "<call>"
},
...
{
...
}],
"codes": [{
"mccmnc": "<mccmnc>",
"cost": "<cost>"
},
...
{
...
}],
"mail": "<mail>"
}

Де:
<zone> - тарифна зона.
<name> - назва тарифної зони (оператор, країна тощо.).
<api> - вартість SMS при відправці через API.
<mass> - вартість SMS при відправці через Особистий кабінет.
<mms> - вартість MMS-повідомлення.
<hlr> - вартість HLR-запиту.
<call> - вартість голосового повідомлення (дзвінок).
<mccmnc> - код країни і мобільного оператора, для якого встановлено індивідуальний тариф.
<cost> - вартість повідомлення за даним індивідуальним тарифом.
<mail> - вартість e-mail повідомлення.

Приклади:

Отримання списку тарифів:

https://smsc.ua/sys/get.php?get_price=1&login=alex&psw=123

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

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


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



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