# Usare gli SDK

> **Traduzione italiana non ufficiale.** Originale: [Using SDK](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/get-started/using-sdk) · [sorgente EN](../../en/get-started/using-sdk.md) · [indice](../../README.md)

La CreatorsAPI fornisce SDK per diversi linguaggi di programmazione per semplificare l'integrazione. Ogni SDK gestisce automaticamente autenticazione, firma delle richieste e comunicazione con l'API, permettendoti di concentrarti sulla costruzione della tua applicazione.

> [!NOTE]
> Prima di usare qualsiasi SDK devi generare le credenziali da Amazon Associates Central. Segui le istruzioni nella guida [Registrarsi alla Creators API](../onboarding/register-for-creators-api.md) per creare le tue credenziali (Client ID, Client Secret e Version).

## SDK disponibili

La CreatorsAPI offre SDK per i seguenti linguaggi:
- **Node.js** — per applicazioni JavaScript/TypeScript
- **Python** — per applicazioni Python
- **PHP** — per applicazioni PHP
- **Java** — per applicazioni Java

## SDK Node.js

![Ultima versione stabile Node.js](../../assets/badges/LatestNodeJsStableVersion.svg)

### Installazione e configurazione

1. **Scarica ed estrai**
   - Scarica [**creatorsapi-nodejs-sdk**](https://affiliate-program.amazon.com/creatorsapi/docs/assets/sdk-archived/creatorsapi-nodejs-sdk.zip) ed estrai l'archivio
   - Spostati nella directory estratta

2. **Installa le dipendenze**
   - Esegui `npm install` per installare tutte le dipendenze richieste
   - Esegui `npm run build` per compilare l'SDK

3. **Configura le credenziali**
   - Apri il progetto con l'editor che preferisci
   - Vai nella directory `examples`
   - Aggiungi il tuo **Credential ID**, **Credential Secret** e **Version** nei file di esempio
   - Aggiungi il **marketplace** a cui vuoi inviare la richiesta (es. "www.amazon.com" per il marketplace USA)
   - Aggiungi un **Partner Tag** valido per il marketplace richiesto nei file di esempio applicabili

4. **Esegui il codice di esempio**
   - Esegui esempi come `node sampleGetItems.js` per ottenere i dettagli di un item
   - Prova `node sampleSearchItems.js` per cercare item

### File di esempio
- `sampleGetItems.js` — recupera le informazioni di un item tramite ASIN
- `sampleSearchItems.js` — cerca item tramite parole chiave

## SDK Python

![Ultima versione stabile Python](../../assets/badges/LatestPythonStableVersion.svg)

### Installazione e configurazione

1. **Scarica ed estrai**
   - Scarica [**creatorsapi-python-sdk**](https://affiliate-program.amazon.com/creatorsapi/docs/assets/sdk-archived/creatorsapi-python-sdk.zip) ed estrai l'archivio
   - Spostati nella directory estratta

2. **Installa le dipendenze**
   - Installa le dipendenze con `pip3 install -r requirements.txt`

3. **Configura le credenziali**
   - Apri il progetto con l'editor che preferisci
   - Vai nella directory `examples`
   - Aggiungi il tuo **Credential ID**, **Credential Secret** e **Version** nei file di esempio
   - Aggiungi il **marketplace** a cui vuoi inviare la richiesta (es. "www.amazon.com" per il marketplace USA)
   - Aggiungi un **Partner Tag** valido per il marketplace richiesto nei file di esempio applicabili

4. **Esegui il codice di esempio**
   - Esegui esempi come `python3 sample_get_items.py` per ottenere i dettagli di un item
   - Prova `python3 sample_search_items.py` per cercare item

### File di esempio
- `sample_get_items.py` — recupera le informazioni di un item tramite ASIN
- `sample_search_items.py` — cerca item tramite parole chiave

## SDK PHP

![Ultima versione stabile PHP](../../assets/badges/LatestPHPStableVersion.svg)

### Installazione e configurazione

1. **Scarica ed estrai**
   - Scarica [**creatorsapi-php-sdk**](https://affiliate-program.amazon.com/creatorsapi/docs/assets/sdk-archived/creatorsapi-php-sdk.zip) ed estrai l'archivio
   - Spostati nella directory estratta

2. **Installa le dipendenze**
   - Installa le dipendenze con `composer install`

3. **Configura le credenziali**
   - Apri il progetto PHP con l'editor che preferisci
   - Vai nella directory `examples`
   - Aggiungi il tuo **Credential ID**, **Credential Secret** e **Version** nei file di esempio
   - Aggiungi il **marketplace** a cui vuoi inviare la richiesta (es. "www.amazon.com" per il marketplace USA)
   - Aggiungi un **Partner Tag** valido per il marketplace richiesto nei file di esempio applicabili

4. **Esegui il codice di esempio**
   - Esegui esempi come `php SampleGetItems.php` per ottenere i dettagli di un item
   - Prova `php SampleSearchItems.php` per cercare item

### File di esempio
- `SampleGetItems.php` — recupera le informazioni di un item tramite ASIN
- `SampleSearchItems.php` — cerca item tramite parole chiave

## SDK Java

![Ultima versione stabile Java](../../assets/badges/LatestJAVAStableVersion.svg)

### Installazione e configurazione

1. **Scarica ed estrai**
   - Scarica [**creatorsapi-java-sdk**](https://affiliate-program.amazon.com/creatorsapi/docs/assets/sdk-archived/creatorsapi-java-sdk.zip) ed estrai l'archivio
   - Spostati nella directory estratta

2. **Configura le credenziali**
   - Apri il progetto con l'editor che preferisci
   - Aggiungi al build path tutti i jar presenti nella cartella `dependencies`
   - Vai nella directory `examples`
   - Aggiungi il tuo **Credential ID**, **Credential Secret** e **Version** nei file di esempio
   - Aggiungi il **marketplace** a cui vuoi inviare la richiesta (es. "www.amazon.com" per il marketplace USA)
   - Aggiungi un **Partner Tag** valido per il marketplace richiesto nei file di esempio applicabili

3. **Esegui il codice di esempio**
   - Esegui esempi come `SampleGetItems.java` per ottenere i dettagli di un item
   - Prova `SampleSearchItems.java` per cercare item

### File di esempio
- `SampleGetItems.java` — recupera le informazioni di un item tramite ASIN
- `SampleSearchItems.java` — cerca item tramite parole chiave

## Best practice

- **Gestione dei token:** l'SDK gestisce automaticamente il caching e il rinnovo degli access token. I token restano in cache fino alla scadenza (1 ora per impostazione predefinita)
- **Gestione degli errori:** implementa sempre una gestione degli errori adeguata nel codice della tua applicazione quando effettui chiamate API
- **Rate limiting:** presta attenzione ai rate limit dell'API. Implementa un throttling appropriato nella tua applicazione
- **Sicurezza:** non committare mai le tue credenziali (Credential ID, Credential Secret) nel version control e non esporle in codice client-side

## Changelog degli SDK

| Versione | Data di rilascio | Modifiche |
|---------|--------------|---------|
| **1.2.0** | 22 febbraio 2026 | • Aggiunto il supporto per le credenziali v3 |
| **1.1.3** | 3 febbraio 2026 | • Corretto il campo Price nell'operazione GetVariations<br>• Correzioni di bug e miglioramenti generali |
| **1.1.2** | 12 gennaio 2026 | • Corretto il funzionamento del parametro SortBy nell'operazione SearchItems<br>• Correzioni di bug e miglioramenti generali |
| **1.1.0** | 9 gennaio 2026 | • Aggiunto il supporto per la Reporting API (generazione e gestione di report S3) |
| **1.0.0** | 15 dicembre 2025 | • Rilascio iniziale degli SDK CreatorsAPI<br>• Supporto per le operazioni della Products API (GetItems, SearchItems, GetBrowseNodes, GetVariations)<br>• Autenticazione e gestione dei token automatiche<br>• Caching dei token con rinnovo automatico |
