![]() |
|
0 (800) 30 7672 Безкоштовно по Україні |
API дозволяє розсилати повідомлення через ваші проекти і сервіси по протоколах HTTP/HTTPS, SMTP і SMPP. Готові бібліотеки на різних мовах програмування підключаються до вашого проекту і допомагають відправляти повідомлення з будь-якого місця за допомогою однієї команди.
ВІДПРАВКА ПОВІДОМЛЕНЬ Відправка SMS-повідомлення УПРАВЛІННЯ РОЗСИЛКАМИКоментарі в SMS-повідомленнях Відправка на групу номерів Відправка HLR-запиту Надсилання MMS-повідомлення Відправка e-mail повідомлення Надсилання голосового повідомлення (дзвінок) Відправка viber-повідомлення Отправка telegram-сообщения Використання префіксів при відправці повідомлень Керування шаблонами повідомлень Керування шаблонами операторів Віртуальна відправка (режим тестування) Повідомлення про події СТАТУСИ ПОВІДОМЛЕНЬ Перевірка статусу ПЕРЕВІРКА СТАНУ БАЛАНСУВідповідь сервера і коди помилок Коди статусів Коди помилок у статусі Видалення повідомлення УПРАВЛІННЯ КОНТАКТАМИ УПРАВЛІННЯ КЛІЄНТАМИ Робота із субклієнтами КЕРУВАННЯ ІМЕНАМИ ВІДПРАВНИКІВ (SENDER ID)Створення і вивантаження рахунків і актів Перелік доступних операцій з іменами відправників ОТРИМАННЯ ДАНИХВідповідь сервера і коди помилок Приклади дій з іменами відправників Отримання історії відправлених повідомлень Отримання вхідних повідомлень Отримання статистики Запит тарифів Отримання інформації про оператора Отримання даних о короткому посиланні ![]() | РізнеПідключення виділених номерів для прийому повідомленьВи можете через спеціальні команди API отримувати список вільних виділених номерів для прийому SMS-повідомлень і підключати будь-який номер до свого логіну, оплачуючи вартість за залишок днів в поточному місяці. При підключенні виділеного номера ви автоматично погоджуєтесь із правилами використання таких номерів.Для отримання списку доступних виділених номерів необхідно викликати методом GET або POST наступну адресу:
https://smsc.ua/sys/receive_phones.php?g Для підключення виділеного номера необхідно викликати методом GET або POST адреси:
https://smsc.ua/sys/receive_phones.php?b Для зміни ознаки продовження виділеного номера на наступний місяць необхідно викликати методом GET або POST адресу:
https://smsc.ua/sys/receive_phones.php?c Опис параметрів, що передаються Серверу:
У разі помилки Сервер повертає наступний рядок:
У разі успішного запиту Сервер повертає відповідь у вигляді рядка. Для отримання списку доступних номерів:
<phone> – номер телефону. <type> – тип номера: 1,4 – виділений віртуальний номер, 2 – номер на послузі SIM-хостингу. <cost> – вартість оренди номера за повний місяць. <current_cost> – вартість оренди номера за залишок днів до кінця поточного місяця. <info> – назва оператора і підтримувані типи повідомлень. Для оренди номера:
<cost> – сума, списана з рахунку Клієнта за оренду номера. Для зміни ознаки продовження номера:
Приклади: Отримання списку вільних номерів для оренди: https://smsc.ua/sys/receive_phones.php?g Підключення номера "79999999999": https://smsc.ua/sys/receive_phones.php?b Відключення можливості продовження виділеного номера "79999999999" на наступний місяць: https://smsc.ua/sys/receive_phones.php?c
Сервер не приймає більше двох однакових запитів протягом хвилини на отримання списку вільних для оренди номерів або підключення номера, або зміна властивостей виділеного номера для зниження навантаження і захисту від помилок і зациклень в програмі на стороні клієнта. Передача статусів і повідомлень на обробник КлієнтаВ особистому кабінеті Клієнта в "Налаштуваннях користувача" є можливість вказати http(s)-адресу (URL) скрипта для обробки статусів доставки повідомлень, вхідних SMS-повідомлень, а також службових повідомлень (при використанні послуги "Підтвердження номеру за допомогою дзвінка") на стороні Клієнта. Зазначений скрипт буде викликатися Сервером після кожного отримання статусу доставки раніше відправленого Клієнтом повідомлення, після отримання вхідного SMS-повідомлення від абонента або дзвінка від абонента (при використанні послуги "Підтвердження номеру за допомогою дзвінка").В адресі обробника можна вказати параметр charset для вибору кодування переданих параметрів:
?charset=utf-8
За замовчуванням використовується кодування windows-1251.
Також в адресі обробника статусів і вхідних повідомлень можна передавати параметр fmt для вказівки формату параметрів, що повертаються. Можливі значення: fmt=2 (для формату xml) і fmt=3 (для формату json). При передачі параметра fmt кодування koi8-r не використовується. Для захисту даних, що передаються від підміни в адресі обробника, додатково можна вказати будь-який із параметрів md5, sha1, crc32, що визначають алгоритм підрахунку контрольного параметра з хешем рядку:
"id:phone:status:<секретная строка>" − для статусу доставки
у вигляді:
?md5=<секретная строка>
В якості символів секретного рядка можна використовувати латинські літери, цифри, мінус і підкреслення.
Оброблювачу буде передано відповідний параметр, в якому секретний рядок буде замінено на значення хешу переданих даних.
Всі параметри передаються методом POST (для fmt=2 и fmt=3 параметры передаются в теле запроса). Параметри, що передані для статусу SMS-повідомлення:
Передані параметри для вхідного SMS-повідомлення:
Передані параметри при використанні послуги "Підтвердження номеру за допомогою дзвінка":
Розширені можливості пошуку, що передаються при використанні функції голосового меню в дзвінках:
Крім описаних вище стандартних параметрів Сервер також буде передавати методом POST всі параметри, зазначені в http(s)-адресі обробника після знаку "?". Для розрізення статусу повідомлення, вхідного SMS-повідомлення або службового повідомлення (при використанні послуги "Підтвердження номера за допомогою дзвінка") в одному обробнику можна виконати перевірку на наявність параметра mes (для вхідного повідомлення) та waitcall (для послуги підтвердження номеру): if (isset($_POST["mes"])) {
Пересилання статусів на обробник Клієнта здійснюється тільки при відправленні повідомлень
по протоколах HTTP/HTTPS, SMTP або SMPP. При відправці повідомлень з особистого кабінету передача статусів на обробник Клієнта
не відбувається. Підключення антиспам перевірки (captcha) до сайтуІноді виникає необхідність відправки повідомлень зі свого сайту за запитом користувачів, і в таких випадках для виключення автоматизованих спам-розсилок за допомогою роботів можна легко впровадити антиспам перевірку, використовуючи наш сервіс.Для цього достатньо на формі для відправки повідомлень розмістити спеціальний код для виведення картинки (captcha) і поля для введення коду: Код с картинки <img src="https://smsc.ua/sys/imgcode.php?1.1" onclick="src+=1" width="50" height="18" border="1">
і передати його з іншими даними форми у відповідний скрипт відправки повідомлень в якості значення параметра imgcode.Також із даним параметром необхідно передавати значення IP-адреси користувача, якому відображалась картинка в якості значення параметраuserip. Приклади: Приклад скрипта для відправки повідомлень, що використовує код з картинки( captcha), отриманий з форми: include_once "smsc_api.php"; Підтвердження номеру телефону за допомогою дзвінкаПри різного роду операціях, таких як відновлення паролів, авторизація в соціальних мережах Wi-Fi, підтвердження грошових переказів, вхід в особистий кабінет і так далі потрібна відправка аутентифікаційних даних. Використовуючи наш API можливо організувати процедуру підтвердження номеру телефону за допомогою дзвінка самим абонентом.Для створення запиту на отримання номеру телефону, за яким абонент повинен буде здійснити підтверджуючий дзвінок, необхідно викликати методом GET або POST адреса:
https://smsc.ua/sys/wait_call.php?login= Серверу передаються наступні параметри:
У разі помилки Сервер повертає наступний рядок:
У разі успішного запиту Сервер повертає відповідь у вигляді рядка.
<phone> – номер телефону, на який протягом 15 хвилин повинен здійснити дзвінок абонент для підтвердження свого номера телефону. <all_phones> – список всіх можливих номерів телефонів, один з яких був призначений системою для дзвінка абонента (в залежності від країни). Після дзвінка абонента Сервер зафіксує факт дзвінка у вигляді вхідного повідомлення з текстом "[waitcall]" і відправить на обробник Клієнта всю необхідну інформацію про даний дзвінок. Сервер не приймає понад п'ятдесят однакових запитів на отримання номеру телефону для підтвердження протягом хвилини для зниження навантаження і захисту від помилок і зациклення в програмі на стороні Клієнта. |
© 2003–2023 ТОВ " СМСЦЕНТР» Код ЄДРПОУ 38404962 | support@smsc.ua Контакти | Дизайн — Студія Артемія Лебедєва Інформація про сайт |
![]() |