API UbillingSMS

Ubilling предоставляет удобную модель абстракции, для работы с очередью SMS сообщений. Начиная со стабильного релиза Ubilling 0.7.1 вы можете использовать в своих модулях базовый класс UbillingSMS для посылки SMS сообщений, особо не волнуясь, что с ними будет происходить в дальнейшем. Начиная с Ubilling 0.8.0 вся работа по дальнейшей обработке любых, в том-числе и SMS сообщений вынесена в отдельную подсистему - Собака-посылака.

Давайте рассмотрим на конкретном примере простейший случай посылки SMS сообщения.

//создаем объект класса
$sms=new UbillingSMS();
//что будем слать?
$message='просто тестовое сообщение';
 
// Складываем SMS в системную очередь для дальнейшей посылки.
// 
// Параметры метода: 1. номер в международном формате (string)
//                   2. текстовое сообщение для посылки (string)
//                   3. принудительная транслитерация сообщения (bool)
//                   4. модуль, по заказу которого производится посылка (string)
 
$sms->sendSMS('+380931234567', $message, false, 'SAMPLEMODULE');

Вот собственно и все. Сообщение будет сложено в общую очередь SMS для последующей отправки через один из поддерживаемых сервисов доставки SMS. С работой с очередью все тоже довольно просто. Мы в любой момент можем узнать, сколько и каких SMS ожидают отправки в данный момент при помощи метода getQueueCount (возвращает int) и получить полное содержимое очереди, при помощи метода getQueueData (возвращает array).

Пример работы с очередью:

$sms = new UbillingSMS();
 
//получаем количество SMS ожидающих отправки
$queueCount = $sms->getQueueCount();
 
if ($queueCount > 0) {
//и если они есть, получаем их содержимое
    $queueData = $sms->getQueueData();
    //показываем содержимое - внтри array
    debarr($queueData);
}
ubillingsms.txt · Последние изменения: 2017/08/17 16:19 — bizzarre
 
За исключением случаев, когда указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki