A referência de API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência de API do [ AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar o AWS Marketplace API Discovery
<a name="discovery-apis"></a>

A API AWS Marketplace Discovery fornece acesso programático ao AWS Marketplace catálogo. Você pode usá-lo para recuperar informações sobre produtos e preços, criar experiências de compras integradas e criar vitrines personalizadas.

## Endpoint de serviço
<a name="discovery-service-endpoint"></a>

A API Discovery usa o seguinte formato de endpoint:

```
https://discovery-marketplace.{{region}}.api.aws
```

Por exemplo, para chamar a API no Leste dos EUA (Norte da Virgínia):

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

## Versão da API
<a name="discovery-api-version"></a>

A versão atual da API é`2026-02-05`.

## Modelo de dados
<a name="discovery-data-model"></a>

A API Discovery organiza o AWS Marketplace catálogo nas seguintes entidades:
+ **Listagem ** — Uma solução de produto ou multiproduto, conforme aparece para os compradores. Um anúncio inclui descrições, destaques, categorias, emblemas, modelos de preços, unidades de preço, avaliações, mídia promocional, contratos com vendedores, tipos de opções de atendimento e referências a produtos e ofertas associados. Use `GetListing` para recuperar um anúncio ou `SearchListings` para pesquisar em todos os anúncios.
+ **Produto ** — O software ou serviço subjacente que está sendo vendido. Um produto inclui descrições, destaques, categorias, mídia promocional, contratos com vendedores e opções de atendimento que descrevem como um comprador pode implantar ou acessar o produto (como AMI, SaaS, Container ou Helm). Use `GetProduct` para recuperar detalhes do produto e `ListFulfillmentOptions` para recuperar opções detalhadas de atendimento de um produto.
+ **Oferta ** — Um acordo de preços para um produto, incluindo o modelo de preços, o vendedor registrado, as datas de disponibilidade e os emblemas. Uma oferta contém termos comerciais, como preços baseados no uso, preços fixos iniciais, períodos de teste gratuitos, documentos legais, cronogramas de pagamento e termos de renovação. Use `ListPurchaseOptions` para encontrar todas as ofertas disponíveis para um produto, `GetOffer` recuperar os detalhes de uma oferta e `GetOfferTerms` recuperar os termos específicos da oferta.
+ **Conjunto de ofertas ** — Uma coleção agrupada de ofertas privadas para cada produto em uma solução multiproduto. Um conjunto de ofertas permite que os compradores analisem todas as ofertas em conjunto e as aceitem simultaneamente com uma única ação. Use `ListPurchaseOptions` para encontrar todos os conjuntos de ofertas disponíveis para um produto, `GetOfferSet` recuperar os detalhes de um conjunto de ofertas, `GetOffer` recuperar os detalhes de uma oferta e `GetOfferTerms` recuperar os termos específicos da oferta.

## Autenticação
<a name="discovery-authentication"></a>

A API Discovery usa a autenticação padrão AWS Signature Version 4 (SigV4). Você precisa ter AWS credenciais válidas e as permissões apropriadas do IAM para chamar a API. Para obter detalhes, consulte [Controle de acesso para o AWS Marketplace API Discovery](discovery-api-access-control.md).

## Fazer solicitações de
<a name="discovery-making-requests"></a>

Todas as operações da API Discovery usam o `POST` método HTTP com um corpo de solicitação JSON. O nome da operação é especificado no caminho do URL.

## Formato de resposta
<a name="discovery-response-format"></a>

Todas as respostas são retornadas no formato JSON. As respostas bem-sucedidas retornam o código de status HTTP 200. As respostas de erro incluem um tipo e uma mensagem de erro. Para obter detalhes, consulte Erros [ comuns](https://docs.aws.amazon.com/marketplace/latest/APIReference/CommonErrors.html).

## Usar o AWS SDK
<a name="discovery-using-sdk"></a>

A forma recomendada de chamar a API Discovery é por meio do AWS SDK. O SDK processa automaticamente a autenticação, a assinatura de solicitações, a serialização e o tratamento de erros.

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

## Paginação
<a name="discovery-pagination"></a>

Operações que retornam listas (como `ListPurchaseOptions` e`SearchFacets`) oferecem suporte ao uso de paginação. `nextToken` Se a resposta incluir um `nextToken` valor, passe-o na próxima solicitação para recuperar resultados adicionais.

## Controle de utilização
<a name="discovery-throttling"></a>

A API Discovery impõe limites de taxa de solicitação para garantir a disponibilidade do serviço. Se você exceder o limite de taxa, a API retornará um `ThrottlingException` (HTTP 429). Implemente a lógica exponencial de recuo e repetição em seu aplicativo.