View a markdown version of this page

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

L'AWS Marketplace API Reference è 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 Marketplace AWS API Discovery

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

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 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. ListPurchaseOptionsUtilizzalo 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

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.

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 URL.

Formato della risposta

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.

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'impaginazione utilizzando. nextToken Se la risposta include un nextToken valore, passalo nella richiesta successiva per recuperare risultati aggiuntivi.

Throttling

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.