Интеграция API для отправки СМС
Спецификация JSON: API
Для связи с сервером браузеру нужен метод POST. На нужный адрес отправляются запросы по протоколу HTTP, для этого используется стандартный формат текста – JSON (JavaScript Object Notation).
Право доступа к ресурсам пользователя осуществляется через протокол авторизации OAuth 2.0. Чтобы аутентифицировать запросы, нужен токен, для получения которого зайдите в Личный кабинет в раздел Профиль. Выберите token и вставьте его в шапку запроса: ‘Authorization: Bearer your_token’.
Как отправлять персонализированные СМС через API
Интернет-адрес службы: https://im.smsclub.mobi/sms/send
{ "phone" : ["380989361131"], "message" : "test text", "src_addr" : "VashZakaz" }
{ "success_request": { "info": { "106": "380989361131" } } }
Как получить статус СМС
Интернет-адрес службы: https://im.smsclub.mobi/sms/status
{ "id_sms" : ["107"], }
{ "success_request": { "info": { "107": "ENROUTE" } } }
Варианты статуса
Ошибки
Получение альфанумерических имен абонентов
Интернет-адрес техподдержки: https://im.smsclub.mobi/sms/originator
Получить активные альфа-имена можно, запросив их по вышеизложенному URL. Достаточно отправить имеющиеся данные, не включающие текстовое содержание.
Если запрос выполнен, программа выдаст список свободных альфа-имен:
{ "success_request": { "info": [ "test1", "test2" ] } }
Как получить баланс пользователя
Интернет-адрес техподдержки: https://im.smsclub.mobi/sms/balance
Если запрос выполнен, программа выдаст массив “info”, в котором:
money — баланс
currency — валюта
{ "success_request": { "info": [ "money": "8121.1800", "currency": "UAH" ] } }