View a markdown version of this page

Utilisation de AWS Marketplace API de découverte - AWS Marketplace
Point de terminaison de serviceVersion de l’APIModèle de donnéesAuthentificationDemandesFormat de la réponseUtilisation de AWS Kit SDKPaginationétranglement

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.

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 est2026-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. ListPurchaseOptionsUtilisez-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. ListPurchaseOptionsUtilisez-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.

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.

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 etSearchFacets) 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.