меню
Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

PHP класс

Для удобства использования UniSender API предлагаем использовать разработанный нами класс для PHP. Данный класс является универсальным, он не будет устаревать, даже если мы добавим новые методы или изменим порядок вызова.

Используя наш класс, вы полностью абстрагируетесь от сетевого уровня и работаете непосредственно с методами UniSender.

Давайте посмотрим, как подключить этот класс к вашему проекту на PHP:

require_once("UniSender/UnisenderApi.php"); //подключаем файл класса
$apikey="abcdefghijklmnopqrstuvwxyz1234567890"; //API-ключ к вашему кабинету
$uni=new Unisender\ApiWrapper\UnisenderApi($apikey); //создаем экземляр класса, 
с которым потом будем работать

Методами класса являются методы API, которые описаны в документации. Например, чтобы создать новый список в вашем личном кабинете, достаточно написать:

$result=$uni->createList(Array("title"=>"OurNewList"));

Заметьте, что API-ключ уже передавать не надо, класс это делает автоматически. В переменную $result будет записан ответ, который придет от API. Ответ кодируется в формат JSON, поэтому, чтобы сделать его читаемым, нужно выполнить следующую команду:

$answer = json_decode($result);

В результате в переменной $answer мы получим массив. Подробная документация метода json_decode представлена здесь.

Разберем более сложный пример — отправку одиночного SMS сообщения посредством метода sendSms.

$phone='+380123456789';
$sender='UniSender';
$text='This is test message from UniSender';
$result=$uni->sendSms(Array("phone"=>$phone,"sender"=>$sender,"text"=>$text));

В переменные $phone, $sender, $text записываются телефон получателя, имя отправителя и текст сообщения соответственно. Дальше мы так же, как и в прошлом примере, вызываем метод sendSms и передаем туда параметры.

Надо заметить, есть методы, где параметр сам по себе представляет собой ассоциативный массив. Пример — параметр fields в методе subscribe. Как поступать в этом случае?

$fields['phone']='+380123456789';
$fields['Name']='UserName';
$fields['email']='test@example.com';

Создаем массив $fields с нужными нам полями. Далее вызываем метод subscribe, передавая массив нужному параметру.

$result=$uni->subscribe(Array(....,"fields"=>$fields,...);

Как видите, нет ничего сложного!

Скачать класс для PHP

require_once("Unisender/ApiWrapper/UnisenderApi")