Merge pull request #20 from MST1122/master

getCredentials('grantless') for grantless operations

Author: lyubo-slavilov

.gitignore

@@ -2,3 +2,4 @@ vendor/
 codelab/
 test.php
 aws-tokens
+.idea

README.md

@@ -6,9 +6,9 @@ Author: Lyubomir Slavilov
 ## Before you start
 Spapi is released as Composer package `double-break/spapi-php` with **no warranties or promises**.
 
-There are couple classes (such as `Signer`, `Credentials`) which are esential for the API calls to work. Most of the issues will live here.
+There are couple classes (such as `Signer`, `Credentials`) which are essential for the API calls to work. Most of the issues will live here.
 
-All of the actual API clients are autogenerated and given the disclamer above - not heavely tested.
+All of the actual API clients are autogenerated and given the disclaimer above - not heavily tested.
 
 ### Requirements
  - php 7.3 (never tested on lower version)
@@ -88,6 +88,7 @@ Name  | Description  |  Type
 
   //Create Credentials service and call getCredentials() to obtain
   //all the tokens needed under the hood
+
   $credentials = new DoubleBreak\Spapi\Credentials($tokenStorage, $signer, $config);
   $cred = $credentials->getCredentials();
 
@@ -96,11 +97,11 @@ Name  | Description  |  Type
   /** The application logic implementation **/
 
 
-  //Create SP API Catalog client and execute one ot its REST methds.
-  $catalogClinet = new DoubleBreak\Spapi\Api\Catalog($cred, $config);
+  //Create SP API Catalog client and execute one ot its REST methods.
+  $catalogClient = new DoubleBreak\Spapi\Api\CatalogItems($cred, $config);
 
   //Check the catalog info for B074Z9QH5F ASIN
-  $result = $catalogClinet->getCatalogItem('B074Z9QH5F', [
+  $result = $catalogClient->getCatalogItem('B074Z9QH5F', [
     'MarketplaceId' => 'A1PA6795UKMFR9',
   ])['payload'];
 
@@ -278,4 +279,60 @@ $result = $authorizationClient->getAuthorizationCode([
 
 //Authorization code should be changed to Access and Refresh token
 print_r($credentials->exchangesAuthorizationCodeForRefreshToken($result['authorizationCode']));
+```
+
+### Authorization for Grantless Operations in Selling Partner API
+
+[Please, see more details in Selling Partner Api docs](https://github.com/amzn/selling-partner-api-docs/blob/main/guides/developer-guide/SellingPartnerApiDeveloperGuide.md#grantless-operations-1)
+
+```php
+<?php
+include __DIR__ . '/vendor/autoload.php';
+
+  /** The Setup **/
+
+$config = [
+    //Guzzle configuration
+    'http' => [
+        'verify' => false,
+        'debug' => true
+    ],
+
+    //LWA: Keys needed to obtain access token from Login With Amazon Service
+    'refresh_token' => '<YOUR-REFRESH-TOKEN>',
+    'client_id' => '<CLINET-ID-IN-SELLER-CONSOLE>',
+    'client_secret' => '<CLIENT_SECRET>',
+
+    //STS: Keys of the IAM role which are needed to generate Secure Session
+    // (a.k.a Secure token) for accessing and assuming the IAM role
+    'access_key' => '<STS-ACCESS_KEY>',
+    'secret_key' => '<STS-SECRET-KEY>',
+    'role_arn' => '<ROLE-ARN>' ,
+
+    //API: Actual configuration related to the SP API :)
+    'region' => 'eu-west-1',
+    'host' => 'sellingpartnerapi-eu.amazon.com'
+];
+
+//Create token storage which will store the temporary tokens
+$tokenStorage = new DoubleBreak\Spapi\SimpleTokenStorage('./aws-tokens');
+
+//Create the request signer which will be automatically used to sign all of the
+//requests to the API
+$signer = new DoubleBreak\Spapi\Signer();
+
+//Create Credentials service and call getCredentials() to obtain
+//all the tokens needed under the hood
+$credentials = new DoubleBreak\Spapi\Credentials($tokenStorage, $signer, $config);
+//get credentials with Grantless auth token, it's needed for grantless operations request
+$cred = $credentials->getCredentials('grantless');
+
+/** The application logic implementation **/
+
+//Create SP API Notification client and execute one ot its REST methods.
+$notificationClient = new DoubleBreak\Spapi\Api\Notifications($cred, $config);
+
+//Get notification destinations
+$result = $notificationClient->getDestinations();
+print_r($result['payload']);
 ```

composer.json

@@ -11,9 +11,9 @@
   "require": {
     "guzzlehttp/guzzle": "^6.5",
     "guzzlehttp/psr7": "^1.7",
-    "patchwork/utf8": "~1.2",
     "ext-simplexml": "*",
-    "ext-json": "*"
+    "ext-json": "*",
+    "ext-zlib": "*"
   },
   "autoload": {
     "psr-4": { "DoubleBreak\\Spapi\\" : "src/" }