Метод для отправки одного СМС-сообщения одному адресату.
GETPOST https://semysms.net/api/3/sms.php
Параметры
-
token
обязательный
- секретный ключ доступа к API
-
device
обязательный
- код устройства из списка ваших подключённых устройств. Одно или несколько через запятую. Значение active означает, что будут использованы все активные устройства аккаунта. Если указано несколько устройств или active, сервис распределяет новые СМС между ними поочерёдно
-
phone
обязательный
- телефон получателя в международном формате с кодом страны
-
msg
обязательный
- текст сообщения, до 1000 символов
-
priority
- приоритет отправки: чем больше число, тем выше приоритет (целое от 0 до 1000000)
-
add_contact
- создавать контакт в списке контактов (0 или пусто - нет, 1 - создать)
-
name
- имя контакта для создания номера в списке контактов
-
surname
- фамилия контакта для создания номера в списке контактов
-
add_plus
- принудительно добавляет символ + к номеру телефона (0 или пусто - не используется, 1 - добавить +)
Пример GET-запроса
Если одно устройство:
https://semysms.net/api/3/sms.php?token=2d9d148edeb50768c22dc6d96f85d60b&device=1&phone=%2B70001234567&msg=Сообщение
Если несколько устройств:
https://semysms.net/api/3/sms.php?token=2d9d148edeb50768c22dc6d96f85d60b&device=1,15,25&phone=%2B70001234567&msg=Сообщение
Пример POST-запроса
<?php
$url = 'https://semysms.net/api/3/sms.php'; // адрес для отправки СМС
$phone = '+70001234567'; // номер телефона
$msg = 'Сообщение'; // сообщение
$device = '1'; // код вашего устройства
$token = '2d9d148edeb50768c22dc6d96f85d60b'; // ваш токен (секретный)
$data = array(
'phone' => $phone,
'msg' => $msg,
'device' => $device,
'token' => $token
);
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($curl);
curl_close($curl);
echo $output;
Пример ответа
{"code":"0","id":1201158}
Отправка нескольких сообщений
Метод для отправки нескольких СМС-сообщений одним запросом. Параметры передаются JSON-телом POST-запроса, массивом data.
POST https://semysms.net/api/3/sms_more.php
Параметры
-
token
обязательный
- секретный ключ доступа к API
-
device
обязательный
- код устройства из списка ваших подключённых устройств
-
phone
обязательный
- телефон получателя в международном формате с кодом страны
-
msg
обязательный
- текст сообщения, до 1000 символов
-
my_id
- код СМС из вашей учётной системы: вернётся в ответе вместе с кодом SemySMS
-
priority
- приоритет отправки: чем больше число, тем выше приоритет (целое от 0 до 1000000)
Пример POST-запроса
<?php
$url = 'https://semysms.net/api/3/sms_more.php'; // адрес для отправки СМС
$device = '1'; // код вашего устройства
$token = '2d9d148edeb50768c22dc6d96f85d60b'; // ваш токен (секретный)
$params = array('token' => $token);
for ($i = 1; $i <= $max_count; $i++) { // заполняем массив номерами, сообщениями и кодами устройств
$params['data'][] = array(
'my_id' => $my_id, // код из вашей системы, вернётся вместе с кодом SemySMS
'device' => $device,
'phone' => $phone,
'msg' => $msg
);
}
$params = json_encode($params);
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
$result = curl_exec($curl);
curl_close($curl);
echo $result;
Пример ответа
{
"code": "0",
"data": [
{ "my_id": "...", "id": 1201158 } // будет значение, если задан в запросе
]
}
