

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á.

# Assinando e acessando um AWS Data Exchange produto contendo APIs
<a name="subscribing-to-API-product"></a>

Os tópicos a seguir descrevem o processo completo de assinatura e acesso a um produto que contém APIs on AWS Data Exchange usando o AWS Data Exchange console. 

Para obter informações sobre como avaliar um produto antes de assiná-lo, consulte [Avaliar produtos contendo dicionários de dados e amostras](subscriber-getting-started.md#evaluate-products).

O processo tem as seguintes etapas:

**Topics**
+ [Etapa 1: Inscrever-se em um produto contendo APIs](#subscribe-to-API-product)
+ [Etapa 2: acessar um produto de API](#use-API-product)

Para praticar a assinatura e o acesso a um produto que contém APIs, consulte o. [AWS Data Exchange para APIs (Produto de teste)](subscriber-tutorial-api-product.md)

## Etapa 1: Inscrever-se em um produto contendo APIs
<a name="subscribe-to-API-product"></a>

Se você assinar um produto pago, sua AWS fatura será cobrada. Você obtém acesso a todos os conjuntos de dados autorizados. Para obter mais informações, consulte [Assinando produtos de AWS Data Exchange dados em AWS Data Exchange](subscribe-to-data-sets.md).

Um fornecedor pode incluir custos medidos em seu produto que contém APIs. Se um provedor diminuir os custos medidos, a redução de preço entrará em vigor imediatamente. Se o provedor aumentar os custos medidos e você já for um assinante, o aumento de preço entrará em vigor no primeiro dia do mês, 90 dias após o envio do aumento de preço OU na renovação (o que ocorrer primeiro). Uma mensagem de e-mail é enviada aos assinantes existentes quando a alteração de preço é enviada. 

**Example**  
Por exemplo, suponha que um provedor apresente um aumento de preço de custo medido no dia 10 de maio. Os assinantes existentes recebem uma mensagem por e-mail sobre a alteração de preço. O aumento de preços entra em vigor no dia 1º de setembro.



**Para assinar um produto que contenha APIs**

1. Abra e faça login no [console do AWS Data Exchange](https://console.aws.amazon.com/dataexchange).

1. No painel de navegação à esquerda, em **Descobrir produtos de dados**, selecione **Pesquisar no catálogo**.

   Para obter mais informações, consulte [Procurar no catálogo](subscriber-getting-started.md#browse-catalog).

1. Em **Refinar resultados**, use o filtro de **tipo de conjunto de dados** e selecione **API** para encontrar produtos que contenham APIs.

   Para obter mais informações, consulte [Procurar no catálogo](subscriber-getting-started.md#browse-catalog).

1. Selecione um produto que contenha APIs e visualize a página de detalhes do produto.

   As informações na página de detalhes do produto incluem uma descrição do produto, as informações de contato do provedor e os detalhes da oferta pública do produto. As informações da oferta pública incluem preço e duração, custos medidos (se incluídos), o contrato de assinatura de dados (DSA) e a política de reembolso. Você pode ver os nomes dos conjuntos de dados incluídos no produto e Regiões da AWS nos quais eles estão disponíveis. Você também pode continuar navegando em outras páginas de detalhes do produto escolhendo um produto em **Produtos similares**.

   Se o provedor tiver emitido uma oferta personalizada para sua conta (por exemplo, uma [oferta privada](subscribe-to-private-offer.md) ou uma [oferta Traga sua própria assinatura [BYOS]](subscribe-to-byos-offer.md)), você também verá esses detalhes.

   1. Em **Oferta pública**, veja os **custos medidos da API** (se incluídos).

   1. (Opcional) Na **Calculadora de custo medido**, escolha **Selecionar custo medido** e insira o número de unidades para exibir um exemplo do custo.

1. No canto superior à direita, escolha **Continuar para assinar**. 

1. Escolha sua combinação preferida de preço e duração, escolha se deseja ativar a renovação automática da assinatura e revise os detalhes da oferta, incluindo o DSA.
**nota**  
Alguns produtos exigem verificação de assinatura. Para obter mais informações, consulte [Verificação de assinatura para assinantes em AWS Data Exchange](subscription-verification-sub.md).

1. Revise as informações de preços, escolha a oferta de preços e selecione **Assinar**.
**nota**  
Se você assinar um produto pago, será solicitado que você confirme sua decisão de assinar.

1. Em **Conjuntos de dados incluídos na sua assinatura**, veja os **Conjuntos de dados** informados.

   Após a conclusão do processamento da assinatura, você poderá escolher um conjunto de dados para acessar seus dados autorizados ou selecionar **Exibir assinatura** para visualizar sua assinatura.

## Etapa 2: acessar um produto de API
<a name="use-API-product"></a>

Os tópicos a seguir fornecem detalhes sobre como acessar um produto que inclui conjuntos de dados de API: 

**Topics**
+ [Visualizar uma API](#view-the-api)
+ [Fazer download da especificação da API](#download-api-spec)
+ [Fazer uma chamada de API (console)](#make-api-call-console)
+ [Fazer uma chamada de API (AWS CLI)](#make-api-call-cli)

### Visualizar uma API
<a name="view-the-api"></a>

**Para visualizar uma API**

1. Abra e faça login no [console do AWS Data Exchange](https://console.aws.amazon.com/dataexchange).

1. No painel de navegação à esquerda, em **Minhas assinaturas**, selecione **Dados autorizados**.

1. Escolha um conjunto de dados.

1. Na guia **Revisões**, escolha uma revisão.

1. Em **Ativos da API**, escolha a API.

1. Veja a **Visão geral do ativo**.

1. Siga as orientações nas **Notas de integração** para chamar a API.

### Fazer download da especificação da API
<a name="download-api-spec"></a>

**Para fazer download da especificação da API**

1. Abra e faça login no [console do AWS Data Exchange](https://console.aws.amazon.com/dataexchange).

1. No painel de navegação à esquerda, em **Minhas assinaturas**, selecione **Dados autorizados**.

1. Escolha um conjunto de dados.

1. Na guia **Revisões**, escolha uma revisão.

1. Em **Ativos da API**, escolha a API.

1. Em **Especificação OpenAPI 3.0**, selecione **Fazer download da especificação da API**.

   Será feito download da especificação no computador local. Você pode então exportar o ativo para uma ferramenta de terceiros para geração de SDK.

### Fazer uma chamada de API (console)
<a name="make-api-call-console"></a>

Você pode chamar um único endpoint no AWS Data Exchange console.

**Para fazer uma chamada de API no console**

1. Abra e faça login no [console do AWS Data Exchange](https://console.aws.amazon.com/dataexchange).

1. No painel de navegação à esquerda, em **Minhas assinaturas**, selecione **Dados autorizados**.

1. Escolha um conjunto de dados.

1. Na guia **Revisões**, escolha uma revisão.

1. Em **Ativos da API**, escolha a API.

1. Em **notas de integração**: 

   1. Escolha **Copiar** para usar o **URL base**.

   1. Escolha **Copiar** para usar a **Estrutura de código**.

   1. Siga as informações fornecidas na documentação de especificação para chamar a API.

### Fazer uma chamada de API (AWS CLI)
<a name="make-api-call-cli"></a>

**Para fazer uma chamada de API (AWS CLI)**
+ Use o comando `send-api-asset` para chamar a API.

  ```
  $ AWS dataexchange send-api-asset \
    --asset-id $ASSET_ID \
    --data-set-id $DATA_SET_ID \
    --revision-id $REVISION_ID \
    --body "..." \
  {
      "headers": {
          ...
      },
      "body": "..."
  }
  ```