flinebux/ukrposhta-api

PHP class for API 0.0.1 ukrainian delivery company "Ukrposhta"

UkrposhtaApi

Класс предоставляет доступ к функциям API Укрпочты, _(*1)

, _(*2)

Подготовка

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

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

Git

Необходимо выполнить в командной строке, _(*4)

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

Composer

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

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

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

composer require flinebux/ukrposhta-api:dev-master

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

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

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

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

$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
   )
  ));