# Comprendere le versioni

> **Traduzione italiana non ufficiale.** Originale: [Understanding Versions](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/concepts/understanding-versions) · [sorgente EN](../../en/concepts/understanding-versions.md) · [indice](../../README.md)

Lavorando con la CreatorsAPI incontrerai diversi numeri di versione. Ecco cosa significa ciascuno:

## Tipi di versione

| Tipo di versione | Esempio | Dove si usa | Scopo | Note |
|--------------|---------|------------|---------|-------|
| **Versione della credenziale** | `2.1`, `3.1` | Header Authorization delle richieste API | Specifica quale formato di credenziale usare per l'autenticazione | Assegnata automaticamente alla creazione delle credenziali in base alla home region del tuo store (NA: 2.1/3.1, EU: 2.2/3.2, FE: 2.3/3.3). La versione determina quale endpoint token usare per l'autenticazione, ma non limita i marketplace a cui puoi accedere. Le credenziali funzionano globalmente su tutti i marketplace, purché tu abbia un Partner Tag valido e l'accesso alla Creators API approvato per la region di destinazione. v2.x usa Cognito, v3.x usa LwA. |
| **Versione dell'SDK** | `1.1.2` | Pacchetto SDK | Indica quale versione della libreria SDK stai usando | Segue il versioning semantico (MAJOR.MINOR.PATCH); vedi [Changelog degli SDK](../get-started/using-sdk.md#changelog-degli-sdk) |
| **Versione dell'API** | `v1` | Path dell'URL dell'endpoint | Identifica quale versione degli endpoint dell'API chiamare | Determina le operazioni e le funzionalità disponibili; la versione corrente è `v1` |
| **Versione della risorsa** | `OffersV2` | Strutture dati della risposta | Specifica quale versione del formato dati vuoi ricevere | Usa versioni più recenti come `OffersV2` per una migliore qualità dei dati e campi aggiuntivi |

---

## Riferimento rapido

### Versione della credenziale
```json
Authorization: Bearer YOUR_ACCESS_TOKEN, Version 2.1
// Usata nell'header Authorization quando si effettuano richieste API
```

### Versione dell'API negli URL degli endpoint
- `/catalog/v1/getItems`
- `/catalog/v1/searchItems`
- `/catalog/v1/getBrowseNodes`
- `/catalog/v1/getVariations`

### Versione della risorsa nelle richieste
```json
{
  "itemIds": ["B08N5WRWNW"],
  "resources": [
    "offersV2.listings.price",
    "offersV2.listings.availability"
  ]
}
```

---

## Documentazione correlata

- [Usare gli SDK](../get-started/using-sdk.md) — configurazione dell'SDK e changelog
- [Registrarsi alla Creators API](../onboarding/register-for-creators-api.md) — generazione delle credenziali
- [Risorsa OffersV2](../api-reference/resources/offersV2.md) — documentazione delle offerte migliorate
- [API Reference](../api-reference.md) — documentazione completa dell'API
