gifts-api

PHP-Library to work with Boomstarter Gifts API.

Tested with PHP 5.3

Примеры использования

1. Вывод списка подарков

Профинансированных подарков. Т.е. на которые деньги уже собраны.

require_once('Boomstarter/API.php');

$shop_uuid = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
$shop_token = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
    
$api = new \Boomstarter\API($shop_uuid, $shop_token);
    
$gifts = $api->getGiftsAll();
    
/* @var $gift Gift */
foreach($gifts as $gift) {
    echo "\t" . "UUID: " . $gift->uuid . "\n";
    echo "\t" . "product_id: " . $gift->product_id . "\n";
    echo "\t" . "name: " . $gift->name . "\n";
    echo "\n";
}

результат

	UUID: 741f2a44-c438-45e8-bfba-daba60609060
	product_id: 128298
	name: Люстра 1172-6U

	UUID: cc7cf13d-a12a-486d-aebb-272360a5f197
	product_id: 35727
	name: Люстра WL11401-6CH

2. Запрос десяти подарков

Вывод общего количества доступных (TotalCount), количества запрошенных (Count), списка подарков. Только профинансированные.

require_once('Boomstarter/API.php');

$shop_uuid = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
$shop_token = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
    
$api = new \Boomstarter\API($shop_uuid, $shop_token);
    
$gifts = $api->getGiftsAll(10);
    
echo "TotalCount: " . $gifts->getTotalCount() . "\n";
echo "Count: " . $gifts->count() . "\n";
echo "Gifts:\n";
    
/* @var $gift Gift */
foreach($gifts as $gift) {
    echo "\t" . "UUID: " . $gift->uuid . "\n";
    echo "\t" . "product_id: " . $gift->product_id . "\n";
    echo "\t" . "name: " . $gift->name . "\n";
    echo "\n";
}

результат

    TotalCount: 100
    Count: 10
    Gifts:
	    UUID: 741f2a44-c438-45e8-bfba-daba60609060
	    product_id: 128298
	    name: Люстра 1172-6U

	    UUID: cc7cf13d-a12a-486d-aebb-272360a5f197
	    product_id: 35727
	    name: Люстра WL11401-6CH
	    
        ...

3. Обработка исключений

    $api = new \Boomstarter\API($shop_uuid, $shop_token);
    
    try {
    
        $gifts = $api->getGiftsAll(10);
    
    } catch (\Boomstarter\Exception $e) {
    
        echo get_class($e) . ': ' . $e->getMessage() . "\n";
        exit(1);
        
    }

результат

    Boomstarter\Exception: Empty response from API server.

Класс API

class API
{
    function __construct($shop_uuid, $shop_token);
    function getGiftsAll();
    function getGiftsPending();
    function getGiftsShipping();
    function getGiftsDelivered();
}

Класс Gift

(подарок)

class Gift
{
    uuid
    product_id
    name
    pledged
    pledged_cents
    comments
    delivery_state
    payout_id
    order_id
    owner
    location
    state
    zipcode
    region
    district
    city
    street
    house
    building
    construction
    apartment
        
    function order($order_id);
    function schedule($delivery_date);
    function setStateDelivery();
}

Структура