# Amazon Creators API — Reference in italiano

Traduzione italiana **non ufficiale** della documentazione della [Amazon Creators API](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction), pensata come reference consultabile dal team di sviluppo e utilizzabile come contesto per strumenti di AI.

La **Creators API** è l'API REST che dà accesso programmatico al catalogo prodotti di Amazon per gli affiliati del programma Associates. È il successore della Product Advertising API 5.0 (PA-API), con autenticazione OAuth 2.0 al posto della firma AWS SigV4. Espone quattro operazioni — `SearchItems`, `GetItems`, `GetVariations`, `GetBrowseNodes` — utili, in ottica hotdeals, per recuperare prezzi, sconti e informazioni sulle offerte (`OffersV2`).

> **Avviso.** Questa è una traduzione a scopo informativo. In caso di dubbi o discrepanze fa fede la [documentazione ufficiale Amazon](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction). Il contratto di licenza è solo un elenco di link ai testi legali ufficiali: vedi [Leggi la licenza](it/license-agreement.md).

## Indice

### Introduzione e migrazione
- [Introduzione](it/introduction.md)
- [Migrare alla Creators API dalla PA-API](it/migrating-to-creatorsapi-from-paapi.md)

### Onboarding
- [Onboarding](it/onboarding.md)
  - [Iscriversi come Amazon Associate](it/onboarding/sign-up-as-an-amazon-associate.md)
  - [Registrarsi alla Creators API](it/onboarding/register-for-creators-api.md)

### Get Started
- [Get Started](it/get-started.md)
  - [Usare gli SDK](it/get-started/using-sdk.md)
  - [Usare cURL](it/get-started/using-curl.md)

### Concetti e linee guida
- [Concetti e linee guida](it/concepts.md)
  - [Rate e limiti dell'API](it/concepts/api-rates.md)
  - [Best practice di programmazione](it/concepts/best-programming-practices.md)
  - [Header e parametri comuni di richiesta](it/concepts/common-request-headers-and-parameters.md)
  - [Comprendere le versioni](it/concepts/understanding-versions.md)

### API Reference
- [API Reference](it/api-reference.md)
  - **Operazioni**
    - [GetBrowseNodes](it/api-reference/operations/get-browse-nodes.md)
    - [GetItems](it/api-reference/operations/get-items.md)
    - [GetVariations](it/api-reference/operations/get-variations.md)
    - [SearchItems](it/api-reference/operations/search-items.md)
  - **Risorse**
    - [BrowseNodeInfo](it/api-reference/resources/browse-node-info.md)
    - [BrowseNodes](it/api-reference/resources/browse-nodes.md)
    - [Images](it/api-reference/resources/images.md)
    - [ItemInfo](it/api-reference/resources/item-info.md)
    - [OffersV2](it/api-reference/resources/offersV2.md)
    - [ParentASIN](it/api-reference/resources/parent-asin.md)
    - [SearchRefinements](it/api-reference/resources/search-refinements.md)
    - [VariationSummary](it/api-reference/resources/variation-summary.md)

### Riferimento dei locale
- [Riferimento dei locale](it/locale-reference.md) — 22 marketplace (Italia, Germania, Francia, UK, USA, …)

### Troubleshooting e supporto
- [Troubleshooting](it/troubleshooting.md)
  - [Codici e messaggi di errore](it/troubleshooting/error-codes-and-messages.md)
  - [Gestione degli errori](it/troubleshooting/processing-of-errors.md)
  - [Troubleshooting delle applicazioni](it/troubleshooting/troubleshooting-applications.md)
- [Domande frequenti](it/frequently-asked-questions.md)
- [Leggi la licenza](it/license-agreement.md)
- [Contatti](it/contact-us.md)

### Knowledge base interna
Conoscenza prodotta dal gruppo, oltre la doc ufficiale: contratti verificati sul campo e comportamenti non documentati da Amazon.
- [Knowledge base](it/knowledge-base/README.md)
  - [Autenticazione per credential version (2.x Cognito vs 3.x LwA)](it/knowledge-base/autenticazione-per-versione.md)
  - [Feed e report: recupero e parsing dei file](it/knowledge-base/feed-e-report.md)

## Struttura della cartella

| Percorso | Contenuto |
| :--- | :--- |
| `it/` | Traduzioni italiane (una pagina per file, stessa struttura dell'originale) |
| `it/knowledge-base/` | Conoscenza autoriale del gruppo (non traduzione): contratti verificati, comportamenti non documentati |
| `en/` | Sorgenti markdown originali in inglese + `toc.json` (indice ufficiale) |
| `assets/images/`, `assets/badges/` | Immagini e badge referenziati dalle pagine |

Ogni pagina italiana riporta in testa un banner con il link alla pagina Amazon originale, al sorgente EN affiancato (per confronto/diff) e all'indice.

## Come aggiornare quando Amazon modifica la doc

I sorgenti sono serviti come markdown pubblici. Per riscaricarli e vedere cosa è cambiato:

1. Scarica l'indice: `curl -s https://affiliate-program.amazon.com/creatorsapi/docs/toc.json`
2. Per ogni pagina elencata, scarica `https://affiliate-program.amazon.com/creatorsapi/docs/assets/<markdown-path>.md`
3. Fai il diff con i file in `en/` per individuare le sezioni cambiate, poi aggiorna le corrispondenti pagine `it/`.

> Nota: `WebFetch`/browser normali ricevono 403 sulle pagine HTML; funzionano invece `curl` sugli asset `.md` e il browser integrato sulle pagine renderizzate.

---

*Sorgente: documentazione Amazon Creators API (en-us). Traduzione non ufficiale. Ultimo allineamento: luglio 2026.*
