SMS API
Используя данное SMS API вы можете настроить отправку сообщений через собственный шлюз.
К примеру:
- у вас есть в наличии VOIP GSM ШЛЮЗ GOIP4 и для экономии средств вы хотели бы настроить отправку SMS сообщений через GSM оператора.
- вы используете SMS шлюз который не поддерживается биллингом -используя данное SMS API вы можете настроить работу через собственный сервис SMS рассылки
Описание API
Принимающая сторона должна проверять указанный ключ api_key
Параметры передаются методом GET, все значение параметров в urlencode
Ответы должны отдаваться в JSON формате, кодировка UTF-8
При отправке СМС отправляется GET запрос по ссылке указанной в настройках.
Параметры запроса:
| from | Альфа-имя указанное в настройках |
| to | Номер телефона получателя |
| uid | UID получателя |
| message | Текст сообщения |
| api_key | API Key указанный в настройках |
Пример ответа при успешной отправке смс:
{"id":234}
где id – уникальный ID транзакции на стороне шлюза
Пример ответа при не успешной отправке смс: {"error":"Error send SMS"}
где error – описание ошибки
Настройки в биллинге
Минимальный пример на PHP
<?php
// Указываем ключ для API
$apiKey = 'ваш_ключ_api';
$response = array();
// Проверим соответствие ключей
if (!empty($_GET['api_key']) AND $_GET['api_key'] == $apiKey) {
$data = array();
foreach ($_GET AS $key => $value){
$data[$key]= urldecode($value);
}
if(isset($data['from'],$data['to'],$data['message'])){
// Отправляем СМС
$result = yourSendFunction($data['from'],$data['to'],$data['message']);
if($result){
$response['id'] = 1; // Если успех, то возвращаем ID собощения в вашей системе
}else{
$response['error'] = 'Error send SMS';
}
}else{
$response['error'] = 'Error. Empty params';
}
} else {
$response['error'] = 'Wrong API Key';
}
// Отправляем ответ
response_json($response);
/**
* Ваша функция отправки СМС
* @param $from
* @param $to
* @param $message
* @return bool
*/
function yourSendFunction($from, $to, $message)
{
#TODO здесь ваш код отправки СМС
return true;
}
/**
* Функция отправки ответа JSON
* @param $response
*/
function response_json($response)
{
$encoded = json_encode($response);
header('Content-type: application/json; charset=utf-8');
exit($encoded);
}
Отправка СМС через Mikrotik LTE
@todo добавить код
