Новая Почта. SDK для личного кабинета API 2
Статья на habrahabr, (*1)
Для быстрого оформления большого количества отправлений используется способ электронного обмена данными между
информационной системой компании «Новая Почта» и программным комплексом Партнера/Клиента. Обмен данными
осуществляется путем передачи информации через программную среду АРІ., (*2)
Для начала работы с функционалом АРІ компании «Новая Почта» необходимо создать ключ на странице настройки в личном
кабинете my.novaposhta.ua. Ключ АРІ обязательно включается в каждый запрос.
Важно! Все создаваемые ключи ограничены во времени действия, настоятельно рекомендуется учитывать данное ограничение., (*3)
SDK разработана по официальной документации. За более детальной информацией по описанию моделей и методов обращайтесь
на страницу официальной документации API 2 личного кабинета: Новой Почты. SDK не является официальным SDK Новой
Почты, я его разработал в личных целях., (*4)
Подключить SDK
Способ 1 (composer)
Самый простой способ установить SDK через composer., (*5)
Создайте файл composer.json в корне Вашего проекта:, (*6)
{
"require": {
"serj1chen/nova-poshta-sdk-php": "2.0.*"
}
}
Установить composer:, (*7)
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar install
Подключить автолоадер composer:, (*8)
include_once "vendor/autoload.php";
Способ 2 (git)
Клонировать репозиторий, (*9)
git clone git://github.com/serj1chen/nova-poshta-sdk-php
Подключить автолоадер SDK:, (*10)
include_once "nova-poshta-sdk-php/lib/NovaPoshta/bootstrap.php";
Структура SDK
Настройка файла конфигурации (Config)
Перед тем как начать работать с API, нужно настроить файл конфигурации:, (*11)
Use NovaPoshta\Config;
Config::setApiKey('<Ваш ключ>');
Config::setFormat(Config::FORMAT_JSONRPC2);
Config::setLanguage(Config::LANGUAGE_UA);
Пример: https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Config_example.php, (*12)
Возможные форматы передачи данных (формат указывать в метод setFormat):, (*13)
- FORMAT_JSON
- FORMAT_JSONRPC2 (рекомендую)
- FORMAT_XML
Работа с моделями SDK (ApiModels)
Все модели лежат в папке ApiModels., (*14)
Модели:, (*15)
В классах моделей описаны все методы в комментариях., (*16)
Работа с методами моделей
Работа с методами модели: save, update, delete. Заполнить модель нужными значениями и вызвать нужный метод. Пример:, (*17)
use NovaPoshta\ApiModels\Counterparty;
$counterparty = new Counterparty();
$counterparty->setCounterpartyProperty('Recipient');
$counterparty->setCityRef('db5c88d0-391c-11dd-90d9-001a92567626');
$counterparty->setCounterpartyType('PrivatePerson');
$counterparty->setFirstName('Пилипко');
$counterparty->setLastName('Вася');
$counterparty->setMiddleName('Сергеевич');
$counterparty->setPhone('+380661122333');
$counterparty->setEmail('test@i.ua');
$result = $counterparty->save();
Работа с статическими методами. В методы передавать объект MethodParameters:, (*18)
use NovaPoshta\ApiModels\Counterparty;
use NovaPoshta\MethodParameters\MethodParameters;
$data = new MethodParameters();
$data->CounterpartyProperty = 'Recipient';
$data->Page = 1;
$data->CityRef = '8d5a980d-391c-11dd-90d9-001a92567626';
$data->FindByString = 'Петр';
$result = Counterparty::getCounterparties($data);
Или можно использовать классы MethodParameters, которые наследуются от класса MethodParameters.
Классы имеют сеттеры параметров, которые можно передать статическому методу модели. Названия классов с параметрами
складываются с двух частей, с названия модели (ApiModels) и названия статического метода модели. Пример использования:, (*19)
use NovaPoshta\ApiModels\Counterparty;
use NovaPoshta\MethodParameters\MethodParameters;
use NovaPoshta\MethodParameters\Counterparty_getCounterparties;
$data = new Counterparty_getCounterparties();
$data->setCounterpartyProperty('Recipient');
$data->setPage(1);
$data->setCityRef('8d5a980d-391c-11dd-90d9-001a92567626');
$data->setFindByString('Петр');
$result = Counterparty::getCounterparties($data);
Модели хелперы для работы с моделями (Models)
Данные классы нужны для заполнения моделей (ApiModels), (*20)
Логирования (Logger)
Если Вам нужно логировать данные отправки/получения запросов. Нужно создать класс который наследуется от Logger.php
и передать экземпляр этого класса в метод setClassLogger файла Config.php., (*21)
use NovaPoshta\Config;
Config::setClassLogger(new Logger_example());
Пример класса логирования: https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Logger_example.php.
(Соответственно у Вас будут данные куда-то записываться), (*22)
Метод setOriginalData: запрос/ответ API Новой Почты.
Параметры: toData - запрос (тип: string); fromData - ответ (тип: string)., (*23)
Метод setData: запрос/ответ API Новой Почты у формате SDK.
Параметры: toData - запрос (объект: DataContainer); fromData - ответ (объект: DataContainerResponse)., (*24)
** SDK не является официальным SDK Новой Почты, (*25)
License
MIT, (*26)
Wallogit.com
