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 de l'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 selon les entités suivantes :

  • Annonce  : produit ou solution multiproduit telle qu'elle apparaît aux acheteurs. Une liste comprend 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 avec les vendeurs, les types d'options d'expédition et des références aux produits et offres associés. GetListingUtilisez-le pour récupérer une annonce ou SearchListings pour effectuer une recherche parmi les annonces.

  • Produit  : logiciel ou service sous-jacent vendu. Un produit comprend des descriptions, des points forts, des catégories, des supports promotionnels, des engagements avec les vendeurs et des options d'expédition qui décrivent comment un acheteur peut déployer le produit ou y accéder (comme AMI, SaaS, Container ou Helm). Permet GetProduct de récupérer les détails du produit et ListFulfillmentOptions de récupérer les options d'expédition détaillées pour un produit.

  • Offre  : arrangement tarifaire pour un produit, y compris le modèle de tarification, le vendeur enregistré, les dates de disponibilité et les badges. Une offre contient des conditions commerciales telles que la tarification basée sur l'utilisation, une tarification initiale fixe, des périodes d'essai gratuites, des documents juridiques, des calendriers de paiement et des conditions de renouvellement. ListPurchaseOptionsUtilisez-le pour rechercher 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 conditions spécifiques de l'offre.

  • Ensemble d'offres  : collection groupée d'offres privées pour chaque produit dans une solution multiproduits. Un ensemble d'offres permet aux acheteurs de passer en revue 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 conditions 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 aux erreurs 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 requête suivante pour récupérer des résultats supplémentaires.

étranglement

L'API Discovery applique des limites de débit de demandes pour 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 d'attente exponentielle et de nouvelle tentative dans votre application.