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 neu strukturiert. 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 Storefronts zu erstellen.

Service-Endpunkt

Die Discovery-API verwendet das folgende Endpunktformat:

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

Zum Beispiel, um die API im Osten der USA (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 Einheiten:

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

  • Produkt — Die zugrunde liegende Software oder Dienstleistung, die verkauft wird. Ein Produkt umfasst Beschreibungen, Highlights, Kategorien, Werbemedien, Verkäuferangebote und Versandoptionen, die beschreiben, wie ein Käufer das Produkt bereitstellen oder darauf zugreifen kann (z. B. AMI, SaaS, Container oder Helm). Dient GetProduct zum Abrufen von Produktdetails und ListFulfillmentOptions zum Abrufen detaillierter Versandoptionen für ein Produkt.

  • Angebot — Eine Preisvereinbarung für ein Produkt, einschließlich Preismodell, registrierter Verkäufer, Verfügbarkeitsdaten und Auszeichnungen. Ein Angebot enthält kommerzielle Bedingungen wie nutzungsabhängige Preise, feste Vorabpreise, 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.

  • Angebotspaket — Eine gruppierte Sammlung von privaten Angeboten für jedes Produkt in einer Lösung mit mehreren Produkten. Ein Angebotsset ermöglicht es Käufern, alle Angebote zusammen zu überprüfen und sie gleichzeitig mit einer einzigen Aktion anzunehmen. Wird verwendet, ListPurchaseOptions um alle verfügbaren Angebotssets für ein Produkt GetOfferSet zu finden, um die Details eines Angebotssets 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 des Vorgangs ist im URL-Pfad angegeben.

Reaktionsformat

Alle Antworten werden im JSON-Format zurückgegeben. Erfolgreiche Antworten geben den HTTP-Statuscode 200 zurück. Zu den Fehlerantworten gehören ein Fehlertyp und eine Fehlermeldung. 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 die Authentifizierung, das Signieren von Anfragen, die Serialisierung und die 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, übergeben Sie ihn in der nächsten Anfrage, um weitere Ergebnisse abzurufen.

Drosselung

Die Discovery-API erzwingt Beschränkungen für die Anforderungsrate, um die Verfügbarkeit des Dienstes 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.