https://github.com/flowdee/paapi5-php-sdk

Amazon Product Advertising API v5 - PHP SDK
https://github.com/flowdee/paapi5-php-sdk

Last synced: 6 days ago
JSON representation

Amazon Product Advertising API v5 - PHP SDK

• Host: GitHub
• URL: https://github.com/flowdee/paapi5-php-sdk
• Owner: flowdee
• License: apache-2.0
• Created: 2019-11-01T09:41:59.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-11-01T10:14:26.000Z (about 5 years ago)
• Last Synced: 2024-11-01T17:51:33.695Z (13 days ago)
• Language: PHP
• Size: 70.3 KB
• Stars: 3
• Watchers: 2
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING.txt

Awesome Lists containing this project

README

        
# Product Advertising API SDK for PHP (v1)

This repository contains the open source PHP SDK that allows you to access the [Product Advertising API](https://webservices.amazon.com/paapi5/documentation/index.html) from your PHP app.

## Installation

The Product Advertising API PHP SDK can be installed with [Composer](https://getcomposer.org/). Run this command:

```sh

$ composer require flowdee/paapi5-php-sdk

```

## Usage

> **Note:** This version of the Product Advertising API SDK for PHP requires PHP 5.5 or greater.

Simple example for searching items.

```php

setAccessKey('');

# Please add your secret key here

$config->setSecretKey('');

# Please add your partner tag (store/tracking id) here

$partnerTag = '';

/*

 * PAAPI host and region to which you want to send request

 * For more details refer: https://webservices.amazon.com/paapi5/documentation/common-request-parameters.html#host-and-region

 */

$config->setHost('webservices.amazon.com');

$config->setRegion('us-east-1');

$apiInstance = new DefaultApi(

/*

 * If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.

 * This is optional, `GuzzleHttp\Client` will be used as default.

 */

    new GuzzleHttp\Client(), $config);

# Request initialization

# Specify keywords

$keyword = 'Harry Potter';

/*

 * Specify the category in which search request is to be made

 * For more details, refer: https://webservices.amazon.com/paapi5/documentation/use-cases/organization-of-items-on-amazon/search-index.html

 */

$searchIndex = "All";

# Specify item count to be returned in search result

$itemCount = 1;

/*

 * Choose resources you want from SearchItemsResource enum

 * For more details, refer: https://webservices.amazon.com/paapi5/documentation/search-items.html#resources-parameter

 */

$resources = array(

    SearchItemsResource::ITEM_INFOTITLE,

    SearchItemsResource::OFFERSLISTINGSPRICE);

# Forming the request

$searchItemsRequest = new SearchItemsRequest();

$searchItemsRequest->setSearchIndex($searchIndex);

$searchItemsRequest->setKeywords($keyword);

$searchItemsRequest->setItemCount($itemCount);

$searchItemsRequest->setPartnerTag($partnerTag);

$searchItemsRequest->setPartnerType(PartnerType::ASSOCIATES);

$searchItemsRequest->setResources($resources);

# Validating request

$invalidPropertyList = $searchItemsRequest->listInvalidProperties();

$length = count($invalidPropertyList);

if ($length > 0) {

    echo "Error forming the request", PHP_EOL;

    foreach ($invalidPropertyList as $invalidProperty) {

        echo $invalidProperty, PHP_EOL;

    }

    return;

}

# Sending the request

try {

    $searchItemsResponse = $apiInstance->searchItems($searchItemsRequest);

    echo 'API called successfully', PHP_EOL;

    echo 'Complete Response: ', $searchItemsResponse, PHP_EOL;

    # Parsing the response

    if ($searchItemsResponse->getSearchResult() != null) {

        echo 'Printing first item information in SearchResult:', PHP_EOL;

        $item = $searchItemsResponse->getSearchResult()->getItems()[0];

        if ($item != null) {

            if ($item->getASIN() != null) {

                echo "ASIN: ", $item->getASIN(), PHP_EOL;

            }

            if ($item->getDetailPageURL() != null) {

                echo "DetailPageURL: ", $item->getDetailPageURL(), PHP_EOL;

            }

            if ($item->getItemInfo() != null

                and $item->getItemInfo()->getTitle() != null

                and $item->getItemInfo()->getTitle()->getDisplayValue() != null) {

                echo "Title: ", $item->getItemInfo()->getTitle()->getDisplayValue(), PHP_EOL;

            }

            if ($item->getOffers() != null

                and $item->getOffers() != null

                and $item->getOffers()->getListings() != null

                and $item->getOffers()->getListings()[0]->getPrice() != null

                and $item->getOffers()->getListings()[0]->getPrice()->getDisplayAmount() != null) {

                echo "Buying price: ", $item->getOffers()->getListings()[0]->getPrice()

                    ->getDisplayAmount(), PHP_EOL;

            }

        }

    }

    if ($searchItemsResponse->getErrors() != null) {

        echo PHP_EOL, 'Printing Errors:', PHP_EOL, 'Printing first error object from list of errors', PHP_EOL;

        echo 'Error code: ', $searchItemsResponse->getErrors()[0]->getCode(), PHP_EOL;

        echo 'Error message: ', $searchItemsResponse->getErrors()[0]->getMessage(), PHP_EOL;

    }

} catch (ApiException $exception) {

    echo "Error calling PA-API 5.0!", PHP_EOL;

    echo "HTTP Status Code: ", $exception->getCode(), PHP_EOL;

    echo "Error Message: ", $exception->getMessage(), PHP_EOL;

    if ($exception->getResponseObject() instanceof ProductAdvertisingAPIClientException) {

        $errors = $exception->getResponseObject()->getErrors();

        foreach ($errors as $error) {

            echo "Error Type: ", $error->getCode(), PHP_EOL;

            echo "Error Message: ", $error->getMessage(), PHP_EOL;

        }

    } else {

        echo "Error response body: ", $exception->getResponseBody(), PHP_EOL;

    }

} catch (Exception $exception) {

    echo "Error Message: ", $exception->getMessage(), PHP_EOL;

}

```

Complete documentation, installation instructions, and examples are available [here](https://webservices.amazon.com/paapi5/documentation/with-sdk.html).