flinebux/ukrposhta-api

PHP class for API 0.0.1 ukrainian delivery company "Ukrposhta"

v1.0.0 2018-10-25 19:30 UTC

This package is auto-updated.

Last update: 2020-12-29 08:02:53 UTC


README

Класс предоставляет доступ к функциям API Укрпочты

Latest Stable Version Total Downloads License

Подготовка

Для использования API необходимо: bearer ключ и token ключ. После получения ключей API предоставляется возможность использовать все методы класса

Установка последней версии класса для работы с API

Git

Необходимо выполнить в командной строке

git clone https://github.com/flinebux/ukrposhta-api

Composer

Необходимо создать файл composer.json со следующим содержанием

{
    "require": {
        "flinebux/ukrposhta-api": "dev-master"
    }
}

и запустить из командной строки команду php composer.phar install или php composer.phar update Или выполнить в командной строке

composer require flinebux/ukrposhta-api:dev-master

Форматы данных

Для входящих данных используются PHP массивы, ответ сервера может быть получен в формате:

  • как PHP массив
  • JSON

Использование

Создание экземпляра класса

$ukrposhtaApi = new UkrposhtaApi('my_bearer','my_token');

Получение последнего статуса о трек-номере

$result = $ukrposhtaApi->modelStatuses('204001234567');

Создание адреса клиента

$address = $ukrposhtaApi->modelAdressPost(array(
"postcode"=>"07401",
"country"=> "UA",
"region"=>"Київська",
"city"=>"Бровари",
"district"=>"Київський",
"street"=>"Котляревського",
"houseNumber"=>"12",
"apartmentNumber"=>"33"
));

Создание отправления

 $address = $ukrposhtaApi->modelShipmentsPost(array(
   "sender" => array(
     "uuid" => "{SenderUuid}"
   ),
   "recipient" => array(
     "uuid"=> "{RecipientUuid}"
   ),
   "deliveryType"=> "W2D",
   "paidByRecipient"=> true,
   "nonCashPayment"=> false,
   "parcels"=> array(
     "weight"=> 1200,
     "length"=> 170
   )
  ));