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 добавить код