View a markdown version of this page

Utilizzo di AWS Marketplace API Discovery - AWS Marketplace
Endpoint del servizioVersione APIModello di datiAutenticazioneEsecuzione di richiesteFormato della rispostaUtilizzo di AWS SDKPaginazioneThrottling

L'API Reference di AWS Marketplace è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

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 AWS Marketplace API Discovery

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

Endpoint del servizio

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

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

Modello di dati

L'API Discovery organizza il AWS Marketplace catalogo nelle seguenti entità:

  • Elenco: un prodotto o una soluzione multiprodotto così come appare agli acquirenti. Un'offerta include descrizioni, punti salienti, categorie, badge, modelli di prezzo, unità di prezzo, recensioni, supporti promozionali, interazioni con i venditori, tipi di opzioni di evasione ordini e riferimenti a prodotti e offerte associati. Utilizzala GetListing per recuperare un'inserzione o per effettuare una ricerca tra le inserzioni. SearchListings

  • Prodotto: il software o il servizio sottostante venduto. Un prodotto include descrizioni, punti salienti, categorie, supporti promozionali, interazioni con i venditori e opzioni di evasione ordini che descrivono in che modo un acquirente può distribuire o accedere al prodotto (come AMI, SaaS, Container o Helm). Utilizzalo GetProduct per recuperare i dettagli del prodotto e ListFulfillmentOptions per recuperare le opzioni di evasione dettagliate per un prodotto.

  • Offerta: un accordo tariffario 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. Utilizzala 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 ciascun prodotto in una soluzione multiprodotto. Un set di offerte consente agli acquirenti di esaminare tutte le offerte insieme e di accettarle contemporaneamente con una sola azione. ListPurchaseOptionsUtilizzalo per trovare tutte le serie di offerte disponibili per un prodotto, GetOfferSet per recuperare i dettagli di una serie di offerte, GetOffer per recuperare i dettagli di un'offerta e GetOfferTerms per recuperare i termini specifici dell'offerta.

Autenticazione

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 AWS Marketplace API Discovery.

Esecuzione di richieste

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

Formato della risposta

Tutte le risposte vengono restituite in formato JSON. Le risposte corrette restituiscono il codice di stato HTTP 200. Le risposte agli errori includono un tipo e un messaggio di errore. Per informazioni dettagliate, consulta Errori comuni.

Utilizzo di AWS SDK

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

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

Throttling

L'API Discovery impone limiti di 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 retry nella tua applicazione.