View a markdown version of this page

Uso de AWS Marketplace API de descubrimiento - AWS Marketplace
punto de conexión de servicioVersión de la APIModelo de datosAutenticaciónRealización de solicitudes deFormato de las respuestasUso de AWS SDKPaginaciónLimitación

Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia de API de AWS Marketplace.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de AWS Marketplace API de descubrimiento

La API AWS Marketplace Discovery proporciona acceso programático al AWS Marketplace catálogo. Puede utilizarla para recuperar información sobre productos y precios, crear experiencias de compra integradas y crear escaparates personalizados.

punto de conexión de servicio

La API Discovery utiliza el siguiente formato de punto final:

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

Por ejemplo, para llamar a la API en EE. UU. Este (Norte de Virginia):

https://discovery-marketplace.us-east-1.api.aws

Versión de la API

La versión actual de la API es2026-02-05.

Modelo de datos

La API Discovery organiza el AWS Marketplace catálogo en las siguientes entidades:

  • Listado: un producto o una solución multiproducto tal como lo ven los compradores. Un anuncio incluye descripciones, aspectos destacados, categorías, distintivos, modelos de precios, unidades de precios, reseñas, medios promocionales, compromisos con los vendedores, tipos de opciones de gestión logística y referencias a los productos y ofertas asociados. GetListingUtilízalo para recuperar un anuncio o SearchListings para buscar en todos los anuncios.

  • Producto: el software o servicio subyacente que se vende. Un producto incluye descripciones, aspectos destacados, categorías, medios promocionales, compromisos con el vendedor y opciones de gestión logística que describen cómo un comprador puede implementar el producto o acceder a él (por ejemplo, AMI, SaaS, Container o Helm). Se utiliza GetProduct para recuperar los detalles del producto y ListFulfillmentOptions las opciones de gestión logística detalladas de un producto.

  • Oferta: acuerdo de precios para un producto, que incluye el modelo de precios, el vendedor registrado, las fechas de disponibilidad y las insignias. La oferta incluye condiciones comerciales, como precios basados en el uso, precios fijos por adelantado, períodos de prueba gratuitos, documentos legales, calendarios de pago y condiciones de renovación. Se utiliza ListPurchaseOptions para buscar todas las ofertas disponibles para un producto, GetOffer para recuperar los detalles de una oferta y GetOfferTerms para recuperar las condiciones específicas de la oferta.

  • Conjunto de ofertas: conjunto agrupado de ofertas privadas para cada producto en una solución multiproducto. Un conjunto de ofertas permite a los compradores revisar todas las ofertas juntas y aceptarlas simultáneamente con una sola acción. Se utiliza ListPurchaseOptions para buscar todos los conjuntos de ofertas disponibles para un producto, GetOfferSet para recuperar los detalles de un conjunto de ofertas, GetOffer para recuperar los detalles de una oferta y GetOfferTerms para recuperar las condiciones específicas de la oferta.

Autenticación

La API Discovery utiliza la autenticación estándar AWS Signature versión 4 (SiGv4). Debe tener AWS credenciales válidas y los permisos de IAM adecuados para llamar a la API. Para obtener más información, consulte Control de acceso para AWS Marketplace API de descubrimiento.

Realización de solicitudes de

Todas las operaciones de la API Discovery utilizan el POST método HTTP con un cuerpo de solicitud JSON. El nombre de la operación se especifica en la ruta URL.

Formato de las respuestas

Todas las respuestas se devuelven en formato JSON. Las respuestas correctas devuelven el código de estado HTTP 200. Las respuestas de error incluyen un tipo de error y un mensaje. Para obtener más información, consulte Errores comunes.

Uso de AWS SDK

La forma recomendada de llamar a la API Discovery es a través del AWS SDK. El SDK gestiona automáticamente la autenticación, la firma de solicitudes, la serialización y la gestión de errores.

# 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);

Paginación

Las operaciones que devuelven listas (como ListPurchaseOptions ySearchFacets) admiten el uso de la paginación. nextToken Si la respuesta incluye un nextToken valor, pásalo en la siguiente solicitud para obtener resultados adicionales.

Limitación

La API Discovery impone límites a la tasa de solicitudes para garantizar la disponibilidad del servicio. Si superas el límite de velocidad, la API devuelve un ThrottlingException (HTTP 429). Implemente una lógica de retroceso exponencial y reintento en su aplicación.