L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di Marketplace AWS API Discovery
<a name="discovery-apis"></a>

L'API Marketplace AWS Discovery fornisce l'accesso programmatico al Marketplace AWS catalogo. Puoi utilizzarla per recuperare informazioni su prodotti e prezzi, creare esperienze di approvvigionamento integrate e creare vetrine personalizzate.

## Endpoint del servizio
<a name="discovery-service-endpoint"></a>

L'API Discovery utilizza il seguente formato di endpoint:

```
https://discovery-marketplace.{{region}}.api.aws
```

Ad esempio, per chiamare l'API negli Stati Uniti orientali (Virginia settentrionale):

```
https://discovery-marketplace.us-east-1.api.aws
```

## Versione API
<a name="discovery-api-version"></a>

La versione attuale dell'API è`2026-02-05`.

## Modello di dati
<a name="discovery-data-model"></a>

L'API Discovery organizza il Marketplace AWS catalogo nelle seguenti entità:
+ **Inserzione**: un prodotto o una soluzione multiprodotto così come appare agli acquirenti. Un'inserzione include descrizioni, punti salienti, categorie, badge, modelli di prezzo, unità di prezzo, recensioni, supporti promozionali, interazioni con i venditori, tipi di opzioni di evasione e riferimenti a prodotti e offerte associati. Utilizzalo `GetListing` per recuperare un'inserzione o per cercare tra le inserzioni. `SearchListings`
+ **Prodotto**: il software o il servizio sottostante venduto. Un prodotto include descrizioni, punti salienti, categorie, supporti promozionali, impegni con i venditori e opzioni di evasione che descrivono in che modo un acquirente può implementare o accedere al prodotto (ad esempio AMI, SaaS, Container o Helm). Utilizzalo `GetProduct` per recuperare i dettagli del prodotto e per recuperare le opzioni di evasione dettagliate `ListFulfillmentOptions` per un prodotto.
+ **Offerta**: una disposizione tariffaria per un prodotto, che include il modello di prezzo, il venditore registrato, le date di disponibilità e i badge. Un'offerta contiene termini commerciali come prezzi basati sull'utilizzo, prezzi fissi anticipati, periodi di prova gratuiti, documenti legali, piani di pagamento e termini di rinnovo. Utilizza `ListPurchaseOptions` per trovare tutte le offerte disponibili per un prodotto, `GetOffer` per recuperare i dettagli di un'offerta e `GetOfferTerms` per recuperare i termini specifici dell'offerta.
+ **Set di offerte**: una raccolta raggruppata di offerte private per ogni prodotto in una soluzione multiprodotto. Un set di offerte consente agli acquirenti di esaminare tutte le offerte insieme e di accettarle contemporaneamente con un'unica azione. `ListPurchaseOptions`Utilizzalo per trovare tutti i set di offerte disponibili per un prodotto, `GetOfferSet` per recuperare i dettagli di un set di offerte, `GetOffer` per recuperare i dettagli di un'offerta e `GetOfferTerms` per recuperare i termini specifici dell'offerta.

## Autenticazione
<a name="discovery-authentication"></a>

L'API Discovery utilizza l'autenticazione AWS Signature Version 4 (SigV4) standard. È necessario disporre di AWS credenziali valide e delle autorizzazioni IAM appropriate per chiamare l'API. Per informazioni dettagliate, vedi [Controllo degli accessi per Marketplace AWS API Discovery](discovery-api-access-control.md).

## Esecuzione di richieste
<a name="discovery-making-requests"></a>

Tutte le operazioni dell'API Discovery utilizzano il `POST` metodo HTTP con un corpo di richiesta JSON. Il nome dell'operazione è specificato nel percorso URL.

## Formato della risposta
<a name="discovery-response-format"></a>

Tutte le risposte vengono restituite in formato JSON. Le risposte riuscite restituiscono il codice di stato HTTP 200. Le risposte di errore includono un tipo e un messaggio di errore. Per i dettagli, consulta [Errori comuni](https://docs.aws.amazon.com//marketplace/latest/APIReference/CommonErrors.html).

## Utilizzo di AWS SDK
<a name="discovery-using-sdk"></a>

Il modo consigliato per chiamare l'API Discovery è tramite l' AWS SDK. L'SDK gestisce automaticamente l'autenticazione, la firma delle richieste, la serializzazione e la gestione degli errori.

```
# Python (Boto3) example
import boto3

client = boto3.client('marketplace-discovery', region_name='us-east-1')

response = client.get_listing(
    listingId='listing-saas-abc123'
)

print(response['listingName'])
```

```
// JavaScript (AWS SDK v3) example
import { MarketplaceDiscoveryClient, GetListingCommand } from "@aws-sdk/client-marketplace-discovery";

const client = new MarketplaceDiscoveryClient({ region: "us-east-1" });
const response = await client.send(new GetListingCommand({
    listingId: "listing-saas-abc123"
}));

console.log(response.listingName);
```

## Paginazione
<a name="discovery-pagination"></a>

Le operazioni che restituiscono elenchi (come `ListPurchaseOptions` e`SearchFacets`) supportano l'impaginazione utilizzando. `nextToken` Se la risposta include un `nextToken` valore, passalo nella richiesta successiva per recuperare risultati aggiuntivi.

## Throttling
<a name="discovery-throttling"></a>

L'API Discovery impone limiti alla frequenza delle richieste per garantire la disponibilità del servizio. Se superi il limite di velocità, l'API restituisce un `ThrottlingException` (HTTP 429). Implementa la logica esponenziale di backoff e riprova nella tua applicazione.