View a markdown version of this page

Verwendung der AWS Marketplace Discovery-API - AWS Marketplace
Service-EndpunktAPI-VersionDatenmodellAuthentifizierungSenden von AnforderungenReaktionsformatVerwendung der AWS SDKPaginierungDrosselung

Die AWS Marketplace-API-Referenz wurde umstrukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace-API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwendung der AWS Marketplace Discovery-API

Die AWS Marketplace Discovery-API bietet programmatischen Zugriff auf den AWS Marketplace Katalog. Sie können sie verwenden, um Produkt- und Preisinformationen abzurufen, integrierte Einkaufserlebnisse zu schaffen und benutzerdefinierte Schaufenster zu erstellen.

Service-Endpunkt

Die Discovery-API verwendet das folgende Endpunktformat:

https://discovery-marketplace.region.api.aws

Um beispielsweise die API in den USA Ost (Nord-Virginia) aufzurufen:

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

API-Version

Die aktuelle API-Version ist2026-02-05.

Datenmodell

Die Discovery-API organisiert den AWS Marketplace Katalog in die folgenden Entitäten:

  • Angebot — Ein Produkt oder eine Lösung mit mehreren Produkten, wie sie den Käufern erscheint. Ein Angebot umfasst Beschreibungen, Hervorhebungen, Kategorien, Logos, Preismodelle, Preiseinheiten, Bewertungen, Werbemedien, Verkäuferinteraktionen, Arten von Versandoptionen und Verweise auf zugehörige Produkte und Angebote. Wird verwendetGetListing, um ein Angebot aufzurufen oder SearchListings um in allen Angeboten zu suchen.

  • Produkt — Die zugrundeliegende Software oder Dienstleistung, die verkauft wird. Ein Produkt umfasst Beschreibungen, Highlights, Kategorien, Werbemedien, Verkäuferbeziehungen und Versandoptionen, die beschreiben, wie ein Käufer das Produkt einsetzen oder darauf zugreifen kann (wie AMI, SaaS, Container oder Helm). Wird verwendetGetProduct, um Produktdetails und ListFulfillmentOptions detaillierte Versandoptionen für ein Produkt abzurufen.

  • Angebot — Eine Preisvereinbarung für ein Produkt, einschließlich des Preismodells, des Rekordverkäufers, der Verfügbarkeitstermine und der Badges. Ein Angebot enthält kommerzielle Bedingungen wie nutzungsabhängige Preise, feste Vorauszahlungen, kostenlose Testzeiträume, rechtliche Dokumente, Zahlungspläne und Verlängerungsbedingungen. Verwenden Sie diese Option, ListPurchaseOptions um alle verfügbaren Angebote für ein Produkt GetOffer zu finden, um die Details eines Angebots abzurufen und GetOfferTerms um die spezifischen Bedingungen des Angebots abzurufen.

  • Angebotssatz — Eine gruppierte Sammlung privater Angebote für jedes Produkt in einer Lösung mit mehreren Produkten. Ein Angebotssatz ermöglicht es Käufern, alle Angebote zusammen zu überprüfen und sie mit einer einzigen Aktion gleichzeitig anzunehmen. Wird verwendet, ListPurchaseOptions um alle verfügbaren Angebotssets für ein Produkt GetOfferSet zu finden, um die Details einer Angebotsgruppe abzurufen, GetOffer um die Details eines Angebots abzurufen und GetOfferTerms um die spezifischen Bedingungen des Angebots abzurufen.

Authentifizierung

Die Discovery-API verwendet die Standardauthentifizierung mit AWS Signature Version 4 (Sigv4). Sie benötigen gültige AWS Anmeldeinformationen und die entsprechenden IAM-Berechtigungen, um die API aufrufen zu können. Details hierzu finden Sie unter Zugriffskontrolle für die AWS Marketplace Discovery-API.

Senden von Anforderungen

Alle Discovery-API-Operationen verwenden die POST HTTP-Methode mit einem JSON-Anforderungstext. Der Name der Operation ist im URL-Pfad angegeben.

Reaktionsformat

Alle Antworten werden im JSON-Format zurückgegeben. Erfolgreiche Antworten geben den HTTP-Statuscode 200 zurück. Die Fehlerantworten enthalten einen Fehlertyp und eine Meldung. Einzelheiten finden Sie unter Häufige Fehler.

Verwendung der AWS SDK

Es wird empfohlen, die Discovery-API über das AWS SDK aufzurufen. Das SDK verarbeitet Authentifizierung, Anforderungssignierung, Serialisierung und Fehlerbehandlung automatisch.

# 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);

Paginierung

Operationen, die Listen zurückgeben (wie ListPurchaseOptions undSearchFacets), unterstützen die Paginierung mithilfe von. nextToken Wenn die Antwort einen nextToken Wert enthält, geben Sie ihn in der nächsten Anfrage weiter, um weitere Ergebnisse abzurufen.

Drosselung

Die Discovery-API setzt Beschränkungen der Anforderungsrate durch, um die Serviceverfügbarkeit sicherzustellen. Wenn Sie das Ratenlimit überschreiten, gibt die API a ThrottlingException (HTTP 429) zurück. Implementieren Sie eine exponentielle Backoff- und Wiederholungslogik in Ihrer Anwendung.