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](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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
<a name="discovery-apis"></a>

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
<a name="discovery-service-endpoint"></a>

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
<a name="discovery-api-version"></a>

Die aktuelle API-Version ist`2026-02-05`.

## Datenmodell
<a name="discovery-data-model"></a>

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 verwendet`GetListing`, 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
<a name="discovery-authentication"></a>

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](discovery-api-access-control.md).

## Senden von Anforderungen
<a name="discovery-making-requests"></a>

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

## Reaktionsformat
<a name="discovery-response-format"></a>

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](https://docs.aws.amazon.com//marketplace/latest/APIReference/CommonErrors.html).

## Verwendung der AWS SDK
<a name="discovery-using-sdk"></a>

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
<a name="discovery-pagination"></a>

Operationen, die Listen zurückgeben (wie `ListPurchaseOptions` und`SearchFacets`), 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
<a name="discovery-throttling"></a>

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.