## Amazon Creators API – GetItems (PHP/Composer)

Esempio minimale, basato sulla documentazione ufficiale, per recuperare informazioni di un prodotto a partire dall’ASIN usando la Creators API.

### Prerequisiti

- PHP 8+
- Composer
- Credenziali Creators API (client id / client secret) e partner tag valido per il marketplace target.

### Installazione

```bash
composer install
```

### Configurazione rapida

Imposta le variabili d’ambiente (o crea un file `.env` nella root del progetto: il loader integrato dell’esempio le legge automaticamente):

```bash
export CREATORS_CLIENT_ID="...client id..."
export CREATORS_CLIENT_SECRET="...client secret..."
export CREATORS_REGION="EU"                      # NA, EU o FE
export CREATORS_CREDENTIAL_VERSION="2.2"         # 2.1 (NA), 2.2 (EU), 2.3 (FE)
export CREATORS_MARKETPLACE="www.amazon.it"      # vedi Common Request Headers and Parameters
export CREATORS_PARTNER_TAG="tuo-store-21"
```

Esempio `.env`:
```
CREATORS_CLIENT_ID=YOUR_CLIENT_ID
CREATORS_CLIENT_SECRET=YOUR_CLIENT_SECRET
CREATORS_REGION=EU
CREATORS_CREDENTIAL_VERSION=2.2
CREATORS_MARKETPLACE=www.amazon.it
CREATORS_PARTNER_TAG=tuo-store-21
```

### Test rapido GetItems

```bash
php tests/get_item.php B0FJ8X2CL4
```

Il client:

1) ottiene il token OAuth2 dal token endpoint regionale (vedi `src/CreatorsApiClient.php`) con `scope=creatorsapi/default`;
2) chiama `https://creatorsapi.amazon/catalog/v1/getItems` con header:
   - `Authorization: Bearer <access_token>, Version <credential_version>`
   - `Content-Type: application/json`
   - `x-marketplace: <marketplace>`
3) invia nel body JSON almeno `itemIds`, `marketplace`, `partnerTag` e, se serve, `resources` (es. `images.primary.small`, `itemInfo.title`, `parentASIN`).

### Note utili (riassunto doc)

- Token endpoint per regione:  
  - NA (2.1) `https://creatorsapi.auth.us-east-1.amazoncognito.com/oauth2/token`  
  - EU (2.2) `https://creatorsapi.auth.eu-south-2.amazoncognito.com/oauth2/token`  
  - FE (2.3) `https://creatorsapi.auth.us-west-2.amazoncognito.com/oauth2/token`
- Base API: `https://creatorsapi.amazon`
- Path GetItems: `/catalog/v1/getItems`
- Max 10 `itemIds` per chiamata; `itemIdType` default `ASIN`.
- Header `Authorization` richiede anche la `Version` della credenziale (2.1/2.2/2.3).
- `partnerTag` deve essere valido per il marketplace scelto.

### Struttura

- `src/CreatorsApiClient.php` – client PHP con fetch token + chiamata GetItems.
- `examples/get_item.php` – esempio CLI.

