Документация разработчика SMSmobileAPI

Документация СМС

В SMSmobileAPI мы стремимся сделать наш API максимально совместимым с любой архитектурой или платформой.
Независимо от того, используете ли вы REST, SOAP, cURL или различные языки программирования, такие как Python, JavaScript, PHP и другие, наш API разработан для бесшовной интеграции в ваши проекты.

У нас также есть готовые к использованию плагины для решений и программного обеспечения для электронной коммерции. Нажмите здесь, чтобы узнать о них.

Нужна помощь? api@smsmobileapi.com

Поиск

Отправить СМС

Эта конечная точка позволяет вам отправлять SMS с вашего мобильного телефона.

Конечная точка:

ПОЛУЧАТЬ ПОЧТА https://api.smsmobileapi.com/sendsms/

Параметры:

Параметр	Описание
apikey	Необходимый Ваш уникальный ключ API.
recipients	Необходимый Номер телефона получателя.
message	Необходимый Сообщение для отправки (длина сообщения не ограничена 160 символами; вы можете отправлять более длинные сообщения)
shorturl	1 = все URL-адреса в сообщении будут автоматически преобразованы в короткие URL-адреса 0 или пустое значение означает, что URL-адреса не будут преобразованы в короткие URL-адреса.
sIdentifiant	Если к вашей учетной записи подключено несколько телефонов, укажите, какой телефон должен отправлять SMS. Каждый телефон имеет уникальный идентификатор — используйте этот идентификатор для выбора устройства. Оставьте это поле пустым, чтобы SMS отправлял первый доступный телефон, или если у вас подключен только один телефон. Для доступа к нему вам потребуется приложение версии 3.0.35.3 или выше.
sendwa	1 = сообщение должно быть отправлено через WhatsApp.
sendsms	1 = сообщение должно быть отправлено посредством традиционного SMS. (Если посылает смс пусто: отправляется по умолчанию, установите 0, чтобы заблокировать SMS)
encrypt_message	да = Сообщение будет зашифровано при прочтении получателем. Получателю необходимо будет ввести уникальный ключ для расшифровки сообщения. Узнайте больше о шифровании сообщений
schedule_timestamp	Представляет время, с которого должно быть отправлено SMS-сообщение. Должно быть Временная метка UNIX (GMT 0)

Пример:

ПОЛУЧИТЕ https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

Примечание: В случае ошибки доставки, вызванной вашим оператором, по умолчанию выполняется повторная отправка того же SMS-сообщения до 3 раз в течение заданного интервала.

Повторно отправить неотправленное SMS

Эта конечная точка API используется для повторной отправки неотправленного SMS (только если сообщение имеет статус ошибки)

Конечная точка:

ПОЛУЧАТЬ ПОЧТА https://api.smsmobileapi.com/resend/

Параметр:

Параметр	Описание
guid	Необходимый GUID сообщения, которое необходимо отправить повторно.

Пример:

ПОЛУЧИТЬ https://api.smsmobileapi.com/resend/?apikey=ВАШ_КЛЮЧ_API&guid=GUID_СООБЩЕНИЯ

Журнал СМС, отправленных из API

Эта конечная точка API используется для извлечения журнала SMS-сообщений, отправленных через API.

Конечная точка:

ПОЛУЧАТЬ https://api.smsmobileapi.com/log/sent/sms/

Параметр:

Параметр	Описание
apikey	Необходимый Ваш ключ API.
guid_message	Сократите до уникального идентификатора сообщения, используемого для сортировки и фильтрации.
before	Извлечь сообщения, отправленные до указанной временной метки или GUID.
error_api	Введите 1, чтобы отобразить список всех SMS-сообщений, в которых возникла ошибка при выполнении запроса к API.
error_mobile	Введите 1, чтобы отобразить список всех SMS-сообщений, в обработке которых на мобильном устройстве возникла ошибка.
keyword	Ключевое слово для фильтрации сообщений по номеру получателя или содержанию SMS.

Пример:

ПОЛУЧИТЕ https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

СМС получено

Эта конечная точка API используется для извлечения SMS-сообщений, полученных на смартфоне.

Конечная точка:

ПОЛУЧАТЬ https://api.smsmobileapi.com/getsms/

Параметр:

Параметр	Описание
apikey	Необходимый API-ключ, который у вас есть или который вы получите.
sIdentifiantPhone	Позволяет изолировать номер телефона, связанный с полученным SMS
after_timestamp_unix	Введите «метку времени». Позволяет выводить список полученных SMS-сообщений после заданной метки времени UNIX.
onlyunread	Введите «да». Позволяет выводить только те SMS-сообщения, которые еще не отмечены как прочитанные (согласно статусу API).

Пример:

ПОЛУЧИТЕ https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Отметить полученные SMS-сообщения как прочитанные

Эта конечная точка API используется для маркировки одного или нескольких полученных SMS-сообщений как прочитанных только в статусе API.
Это означает, что статус прочтения обновляется на стороне API, что помогает вам отфильтровывать уже обработанные сообщения при использовании фильтра onlyunread=yes.

Важный:
Это действие не влияет на статус чтения на самом смартфоне — изменение применяется только к статусу API, а не к приложению обмена сообщениями или статусу системы на устройстве.

Конечная точка:

ПОЛУЧАТЬ https://api.smsmobileapi.com/getsms/set-read/

Параметр:

Параметр	Описание
apikey	Необходимый API-ключ, который у вас есть или который вы получите.
guid_message	Необходимый GUID сообщения, которое нужно отметить как прочитанное

Пример:

ПОЛУЧИТЬ https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE

Удалить СМС

Эта конечная точка API используется для удаления SMS-сообщений из журнала сервера SMS Mobile API.

Конечная точка:

ПОЛУЧАТЬ https://api.smsmobileapi.com/deletesms/

Параметр:

Параметр	Описание
apikey	Необходимый Имеющийся у вас ключ API.
guid_message	Уникальный идентификатор сообщения, которое нужно удалить.
date_start	При использовании отдельно удаляет все сообщения за указанный день.
date_start and date_end	Объединено для удаления сообщений в течение указанного периода.

Пример:

ПОЛУЧИТЬ https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Примечание: Удаляются только те SMS-сообщения, которые хранятся в журналах вашей учетной записи мобильного приложения. SMS-сообщения на самом мобильном устройстве удаляться не будут, так как у нас нет к ним доступа.

Webhook – получено SMS

Эта система веб-перехватчиков отправляет запрос POST на настроенный URL-адрес всякий раз, когда получено SMS. Система обеспечивает обновления в реальном времени, доставляя данные SMS на указанный URL-адрес веб-перехватчика.

Как настроить Webhook на панели управления

Чтобы настроить URL-адрес веб-перехватчика на панели управления, выполните следующие действия:

Войдите в свою учетную запись на Панель управления SMS Mobile API.
Перейдите к Настройки вебхука раздел.
Введите URL вашего вебхука (например, https://example.com/webhook-endpoint).
Нажмите на Сохранить вебхук кнопка.
После сохранения система начнет отправлять SMS-сообщения на настроенный URL-адрес.

Полезная нагрузка веб-перехватчика

При получении SMS-сообщения система отправляет следующую полезную нагрузку JSON на ваш URL-адрес веб-перехватчика:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hello, this is a test."", "number": "+123456789", "guid": "abcde12345" }

Поля полезной нагрузки:

дата: Дата добавления SMS (ГГГГ-ММ-ДД).
час: Час добавления SMS (ЧЧ:мм:сс).
время_получения: Время получения SMS.
сообщение: Содержание СМС.
число: Номер телефона отправителя.
руководство: Уникальный идентификатор SMS.

Пример конечной точки WebHook

Ваш сервер должен быть готов обрабатывать входящие запросы POST. Ниже приведен пример скрипта PHP для обработки полезной нагрузки веб-перехватчика:

Тестирование Webhook

Чтобы проверить конфигурацию вашего вебхука, используйте такие инструменты, как:

Поиск неисправностей

Убедитесь, что URL-адрес веб-хука правильный и общедоступный.
Убедитесь, что ваш сервер возвращает код состояния HTTP 200 для успешных запросов.
Проверьте журналы сервера на наличие ошибок при обработке полезной нагрузки.

Обогащенные SMS

Вскоре

Аутентификация

API SMSMobile поддерживает два метода аутентификации: с использованием простого ключа API или протокола OAuth2 с идентификатором клиента и секретным ключом клиента.

1. Аутентификация API-ключа

Этот метод требует API Key, который может быть включен в качестве параметра в запрос GET или POST. Это простой способ аутентификации ваших API-запросов.

2. Аутентификация OAuth2

OAuth2 обеспечивает более безопасный и масштабируемый метод аутентификации.
Вам нужно будет использовать идентификатор клиента и секретный ключ клиента для получения токена доступа, который затем следует включить в ваши запросы API с помощью Авторизация заголовок.

Идентификатор клиента и секрет клиента доступны на панели управления, доступной после установки приложения и создания учетной записи на мобильном устройстве.
Загрузите мобильное приложение прямо сейчас или получить доступ к своей панели управления.

Получение токена доступа

Чтобы получить токен доступа, отправьте POST-запрос на конечную точку токена, указав свой идентификатор клиента и секретный ключ клиента.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Использование токена доступа:

Получив токен доступа, включите его в Авторизация Заголовок ваших API-запросов:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Авторизация: Носитель abc123xyz456" \

-H "Тип содержимого: application/x-www-form-urlencoded" \

-d "получатели=+1234567890" \

-d "сообщение=Привет"

Какой метод следует использовать?

- Использовать Аутентификация API-ключа для быстрой и простой интеграции.

- Использовать Аутентификация OAuth2 для повышения безопасности и масштабируемости ваших интеграций.

Более подробную информацию можно найти в полной документации.

Отправить СМС

URL-адрес WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Параметры:

- recipients: Номер мобильного телефона получателя.
- message: Сообщение для отправки. (Длина сообщения не ограничена 160 символами; вы можете отправлять более длинные сообщения)
- apikey: API-ключ, который у вас есть или который вы получите.

Пример


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

Отправить СМС и WhatsApp

Базовая команда cURL

Для отправки SMS через SMSmobileAPI можно использовать следующую команду cURL:


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

Пример cURL на PHP

Если вы используете PHP, вот как вы можете отправить SMS с помощью cURL:


<?php


$url = 'https://api.smsmobileapi.com/sendsms/';

$data = array(

    'recipients' => 'PHONE_NUMBER',

    'message' => 'YOUR_MESSAGE',

    'apikey' => 'YOUR_API_KEY',

    'sendwa' => '1',

    'sendsms' => '1'

);


$options = array(

    CURLOPT_URL => $url,

    CURLOPT_POST => true,

    CURLOPT_POSTFIELDS => http_build_query($data),

    CURLOPT_RETURNTRANSFER => true,

);


$ch = curl_init();

curl_setopt_array($ch, $options);

$response = curl_exec($ch);

curl_close($ch);


echo $response;


?>

В этом примере PHP показано, как отправить запрос POST с помощью cURL в SMSmobileAPI, передав необходимые параметры в виде ассоциативного массива.

Отправить СМС и WhatsApp

Используйте наш официальный модуль Python: https://smsmobileapi.com/python/

или используйте ручной способ ...

Используя `запросы` Библиотека

The запросы Эта библиотека — популярная и простая HTTP-библиотека для Python. Вот как её можно использовать для отправки SMS через SMSmobileAPI:


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {

    "recipients": "PHONE_NUMBER",

    "message": "YOUR_MESSAGE",

    "apikey": "YOUR_API_KEY"

}


response = requests.post(url, data=payload)


print(response.text)

Используя `http.client` Библиотека

The http.client Эта библиотека входит в стандартную библиотеку Python и может также использоваться для взаимодействия с вашим API:


import http.client

import urllib.parse


conn = http.client.HTTPSConnection("api.smsmobileapi.com")


params = urllib.parse.urlencode({

    "recipients": "PHONE_NUMBER",

    "message": "YOUR_MESSAGE",

    "apikey": "YOUR_API_KEY"

})


headers = { "Content-type": "application/x-www-form-urlencoded" }


conn.request("POST", "/sendsms/", params, headers)

response = conn.getresponse()

data = response.read()


print(data.decode("utf-8"))

conn.close()

SMS Mobile API - PHP SDK (Composer)

SMS Mobile API PHP SDK доступен через Composer, что упрощает интеграцию отправки SMS в ваши PHP-приложения.
композитор требует smsmobileapi/sdk

Подробную документацию, инструкции по установке и примеры использования можно найти в нашем репозитории GitHub:

🔗 SMS Mobile API PHP SDK на GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

На GitHub вы найдете:
✔️ Полное руководство по установке
✔️ Пример использования
✔️ Справочник API и лучшие практики

Нужна помощь? Не стесняйтесь открыть issue на GitHub! 🎯

Отправить СМС и WhatsApp

Используя `принести` API

The принести API — это современный и универсальный способ выполнения HTTP-запросов на JavaScript. Вот как вы можете использовать его для отправки SMS через SMSmobileAPI:


const url = "https://api.smsmobileapi.com/sendsms/";


const data = {

    recipients: "PHONE_NUMBER",

    message: "YOUR_MESSAGE",

    apikey: "YOUR_API_KEY"

};


fetch(url, {

    method: "POST",

    headers: {

        "Content-Type": "application/x-www-form-urlencoded"

    },

    body: new URLSearchParams(data)

})

.then(response => response.text())

.then(result => console.log(result))

.catch(error => console.error("Error:", error));

С использованием `XMLHttpRequest`

Если вам необходимо обеспечить поддержку старых браузеров, вы можете использовать... XMLHttpRequest объект:


const xhr = new XMLHttpRequest();

const url = "https://api.smsmobileapi.com/sendsms/";


const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";


xhr.open("POST", url, true);

xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");


xhr.onreadystatechange = function() {

    if (xhr.readyState === 4 && xhr.status === 200) {

        console.log(xhr.responseText);

    }

};


xhr.send(data);

Отправить СМС и WhatsApp

Используя `аксиос` Библиотека

The аксиос Эта библиотека — популярный HTTP-клиент для Node.js. Вот как её можно использовать для отправки SMS через SMSmobileAPI:


const axios = require('axios');


const url = 'https://api.smsmobileapi.com/sendsms/';

const data = {

    recipients: 'PHONE_NUMBER',

    message: 'YOUR_MESSAGE',

    apikey: 'YOUR_API_KEY'

};


axios.post(url, data)

.then(response => {

    console.log(response.data);

})

.catch(error => {

    console.error('Error:', error);

});

Отправить СМС и WhatsApp

Используя `Сеть::HTTP` Библиотека

Вы можете использовать Сеть::HTTP Библиотека на Ruby для отправки SMS через SMSmobileAPI:


require 'net/http'

require 'uri'


uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

request = Net::HTTP::Post.new(uri)

request.set_form_data(

    "recipients" => "PHONE_NUMBER",

    "message" => "YOUR_MESSAGE",

    "apikey" => "YOUR_API_KEY"

)


req_options = {

    use_ssl: uri.scheme == "https",

}


response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

    http.request(request)

end


puts response.body

Нажмите здесь, чтобы протестировать ключ API и сервис с помощью простой формы.

В зависимости от версии Android, установленной на мобильном телефоне, операционная система может препятствовать корректной работе автоматической отправки и получения SMS-сообщений, когда приложение SmsMobileApi не находится на переднем плане.
Эта проблема возникает из-за процесса, который пытается работать в фоновом режиме, когда приложение не запущено активно. Однако из-за мер оптимизации батареи Android, которые различаются в разных версиях, этот фоновый процесс может запускаться некорректно. Оптимизация батареи Android предназначена для ограничения фоновой активности приложений с целью экономии заряда батареи, что может непреднамеренно повлиять на приложения, которым для правильной работы требуются фоновые процессы.

Чтобы решить эту проблему, пользователи могут вручную настроить параметры Android, чтобы разрешить SmsMobileApi использовать ресурсы без ограничений.
Это включает в себя настройку параметров оптимизации батареи для конкретного приложения, по сути, указав Android, что SmsMobileApi разрешено работать в фоновом режиме и использовать ресурсы по мере необходимости. При этом приложение должно иметь возможность автоматически отправлять и получать SMS-сообщения, даже если оно не является активным приложением на переднем плане. Эта настройка гарантирует, что необходимый фоновый процесс может работать бесперебойно, обходя функции оптимизации батареи, которые в противном случае могли бы помешать его правильному выполнению.

Часто задаваемые вопросы для разработчиков

Как сгенерировать ключ API?

Описание примера аккордеонаЧтобы сгенерировать ключ API, загрузите наше приложение на свой мобильный телефон и создайте учетную запись бесплатно. Ключ API будет автоматически сгенерирован и привязан к вашему мобильному телефону. Вы также получите электронное письмо со всей необходимой информацией. Этот процесс гарантирует, что вы сможете быстро и легко начать пользоваться нашими услугами с минимальной настройкой.

Где я всегда могу найти свой ключ API?

В вашем мобильном приложении перейдите в меню НАСТРОЙКИ или ПОМОЩЬ, где ваш ключ API виден в любое время. Это гарантирует, что вы сможете легко получить доступ к своему ключу API, когда он вам понадобится для интеграции или использования наших сервисов.

Может ли создание API-ключа быть анонимным?

Да, мы не требуем никаких доказательств личности для создания ключа API. Таким образом, связь между нашим API и вашим мобильным телефоном является 100% анонимной. Такой подход позволяет пользователям сохранять свою конфиденциальность при использовании наших услуг.

Начните работу с SMSmobileAPI уже сегодня!

Ощутите свободу и гибкость управления вашими SMS-сервисами на ходу. Загрузите наше мобильное приложение сейчас и сделайте первый шаг к бесшовной интеграции SMS.

Загрузить приложение

API и документация для разработчиков

Журнал инструментов и изменений

Отправить СМС

Конечная точка:

Параметры:

Пример:

Повторно отправить неотправленное SMS

Конечная точка:

Параметр:

Пример:

Журнал СМС, отправленных из API

Конечная точка:

Параметр:

Пример:

СМС получено

Конечная точка:

Параметр:

Пример:

Отметить полученные SMS-сообщения как прочитанные

Конечная точка:

Параметр:

Пример:

Удалить СМС

Конечная точка:

Параметр:

Пример:

Webhook – получено SMS

Как настроить Webhook на панели управления

Полезная нагрузка веб-перехватчика

Поля полезной нагрузки:

Пример конечной точки WebHook

Тестирование Webhook

Поиск неисправностей

Обогащенные SMS

Аутентификация

1. Аутентификация API-ключа

2. Аутентификация OAuth2

Получение токена доступа

Использование токена доступа:

Какой метод следует использовать?

Отправить СМС

URL-адрес WSDL

Параметры:

Пример

Отправить СМС и WhatsApp

Базовая команда cURL

Пример cURL на PHP

Отправить СМС и WhatsApp

Используя запросы Библиотека

Используя http.client Библиотека

SMS Mobile API - PHP SDK (Composer)

Отправить СМС и WhatsApp

Используя принести API

С использованием XMLHttpRequest

Отправить СМС и WhatsApp

Используя аксиос Библиотека

Отправить СМС и WhatsApp

Используя Сеть::HTTP Библиотека

Часто задаваемые вопросы для разработчиков

Как сгенерировать ключ API?

Где я всегда могу найти свой ключ API?

Может ли создание API-ключа быть анонимным?

Начните работу с SMSmobileAPI уже сегодня!

💬 Доступен онлайн-чат

Используя `запросы` Библиотека

Используя `http.client` Библиотека

Используя `принести` API

С использованием `XMLHttpRequest`

Используя `аксиос` Библиотека

Используя `Сеть::HTTP` Библиотека