La référence d'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel [AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation de AWS Marketplace API de découverte
L'API AWS Marketplace Discovery fournit un accès programmatique au AWS Marketplace catalogue. Vous pouvez l'utiliser pour récupérer des informations sur les produits et les prix, créer des expériences d'approvisionnement intégrées et créer des vitrines personnalisées.
## Point de terminaison de service
L'API Discovery utilise le format de point de terminaison suivant :
```
https://discovery-marketplace.{{region}}.api.aws
```
Par exemple, pour appeler l'API dans l'est des États-Unis (Virginie du Nord) :
```
https://discovery-marketplace.us-east-1.api.aws
```
## Version de l’API
La version actuelle de l'API est`2026-02-05`.
## Modèle de données
L'API Discovery organise le AWS Marketplace catalogue dans les entités suivantes :
+ **Mise en vente** : produit ou solution multiproduits telle qu'elle apparaît aux yeux des acheteurs. Une liste inclut des descriptions, des points forts, des catégories, des badges, des modèles de tarification, des unités de prix, des avis, des supports promotionnels, des engagements des vendeurs, des types d'options d'expédition et des références aux produits et offres associés. `GetListing`À utiliser pour récupérer une annonce ou `SearchListings` pour effectuer une recherche dans plusieurs annonces.
+ **Produit** : logiciel ou service sous-jacent vendu. Un produit inclut des descriptions, des points forts, des catégories, des supports promotionnels, des engagements des vendeurs et des options d'expédition qui décrivent comment un acheteur peut déployer le produit ou y accéder (AMI, SAAS, Container ou Helm, par exemple). `GetProduct`À utiliser pour récupérer les détails du produit et `ListFulfillmentOptions` les options d'expédition détaillées pour un produit.
+ **Offre** — Un accord tarifaire pour un produit, y compris le modèle de tarification, le vendeur officiel, les dates de disponibilité et les badges. Une offre contient des conditions commerciales telles que la tarification basée sur l'utilisation, la tarification initiale fixe, les périodes d'essai gratuites, les documents juridiques, les calendriers de paiement et les conditions de renouvellement. `ListPurchaseOptions`Utilisez-le pour trouver toutes les offres disponibles pour un produit, `GetOffer` pour récupérer les détails d'une offre et `GetOfferTerms` pour récupérer les termes spécifiques de l'offre.
+ **Ensemble d'offres** : collection groupée d'offres privées pour chaque produit dans le cadre d'une solution multiproduits. Un ensemble d'offres permet aux acheteurs de consulter toutes les offres ensemble et de les accepter simultanément en une seule action. `ListPurchaseOptions`Utilisez-le pour rechercher tous les ensembles d'offres disponibles pour un produit, `GetOfferSet` pour récupérer les détails d'un ensemble d'offres, `GetOffer` pour récupérer les détails d'une offre et `GetOfferTerms` pour récupérer les termes spécifiques de l'offre.
## Authentification
L'API Discovery utilise l'authentification standard AWS Signature Version 4 (SigV4). Vous devez disposer AWS d'informations d'identification valides et des autorisations IAM appropriées pour appeler l'API. Pour en savoir plus, consultez [Contrôle d'accès pour AWS Marketplace API de découverte](discovery-api-access-control.md).
## Demandes
Toutes les opérations de l'API Discovery utilisent la `POST` méthode HTTP avec un corps de requête JSON. Le nom de l'opération est spécifié dans le chemin de l'URL.
## Format de la réponse
Toutes les réponses sont renvoyées au format JSON. Les réponses réussies renvoient le code d'état HTTP 200. Les réponses d'erreur incluent un type d'erreur et un message. Pour plus de détails, consultez la section [Erreurs courantes](https://docs.aws.amazon.com//marketplace/latest/APIReference/CommonErrors.html).
## Utilisation de AWS Kit SDK
La méthode recommandée pour appeler l'API Discovery consiste à utiliser le AWS SDK. Le SDK gère automatiquement l'authentification, la signature des demandes, la sérialisation et la gestion des erreurs.
```
# 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);
```
## Pagination
Les opérations qui renvoient des listes (telles que `ListPurchaseOptions` et`SearchFacets`) prennent en charge la pagination à l'aide `nextToken` de. Si la réponse inclut une `nextToken` valeur, transmettez-la dans la demande suivante pour obtenir des résultats supplémentaires.
## étranglement
L'API Discovery impose des limites de taux de demandes afin de garantir la disponibilité du service. Si vous dépassez la limite de débit, l'API renvoie un `ThrottlingException` (HTTP 429). Implémentez une logique de ralentissement exponentiel et de nouvelle tentative dans votre application.