cedcommerce / allegro-sdk

1.0.1 2021-10-01 10:52 UTC

MIT

Published on Packagist.org on 2021-10-01 14:04 UTC

README

Simple interface for Allegro REST API resources

Authorization and Tokens

In order to use Allegro REST Api, you have to register your application and authorize it (https://developer.allegroapi.io/auth/).

Authorization link

$api = new Api($clientId, $clientSecret, $apiKey, $redirectUri, null, null);
echo $api->getAuthorizationUri();

Getting new token

# example contents of your_redirect_uri.com/index.php
$code = $_GET['code'];
$api = new Api($clientId, $clientSecret, $apiKey, $redirectUri, null, null);
$response = $api->getNewAccessToken($code);
# response contains json with your access_token and refresh_token

Refreshing existing token

$api = new Api($clientId, $clientSecret, $apiKey, $redirectUri, $accessToken, $refreshToken);
$response = $api->refreshAccessToken();
# response contains json with your new access_token and refresh_token

Example usage

$api = new Api($clientId, $clientSecret, $apiKey, $redirectUri, $accessToken, $refreshToken);

// GET https://allegroapi.io/{resource}
// $api->{resource}->get();

// GET https://allegroapi.io/categories
$api->categories->get();

// GET https://allegroapi.io/{resource}/{resource_id}
// $api->{resource}({resource_id})->get();

// GET https://allegroapi.io/categories/2
$api->categories(2)->get();

// PUT https://allegroapi.io/{resource}/{resource_id}/{command-name}-command/{uuid}
// $api->{resource}({resource_id})->commands()->{command_name}($data);

// PUT https://allegroapi.io/offers/12345/change-price-commands/84c16171-233a-42de-8115-1f1235c8bc0f
$api->offers(12345)->commands()->change_price($data);