Для удобства использования Unisender API предлагаем попробовать разработанный нами класс для PHP. Данный класс является универсальным, он не будет устаревать, даже если мы добавим новые методы или изменим порядок вызова.
Используя наш класс, вы полностью абстрагируетесь от сетевого уровня и работаете непосредственно с методами Unisender.
Как подключить PHP класс к вашему проекту на PHP
require_once("Unisender/UnisenderApi.php"); //подключаем файл класса
$apikey="abcdefghijklmnopqrstuvwxyz1234567890"; //API-ключ к вашему кабинету
$uni=new UnisenderApiWrapperUnisenderApi($apikey); //создаем экземпляр класса,
с которым потом будем работать
Методами класса являются методы API, которые описаны в документации. Например, чтобы создать новый список в вашем личном кабинете, достаточно написать:
$result=$uni->createList(Array("title"=>"OurNewList"));
Заметьте, что API-ключ уже передавать не надо, класс это делает автоматически. В переменную $result будет записан ответ, который придет от API. Ответ кодируется в формат JSON, поэтому, чтобы сделать его читаемым, нужно выполнить следующую команду:
$answer = json_decode($result);
Подробная документация метода 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 с нужными нам полями.
$fields['phone']='+380123456789'; $fields['Name']='UserName'; $fields['email']='test@example.com';
Далее вызываем метод subscribe, передавая массив нужному параметру.
$result=$uni->subscribe(Array(....,"fields"=>$fields,...);
