

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

# AWS Data Exchange para APIs (Produto de teste)
<a name="subscriber-tutorial-api-product"></a>

AWS Data Exchange for APIs (Test Product) é um produto gratuito que é disponibilizado aos assinantes para entender como interagir com um AWS Data Exchange produto que contém conjuntos de dados de API. Você pode usar esse produto para fins de teste e para saber como fazer chamadas de API a provedores para recuperar dados baseados em API.

AWS Data Exchange for APIs (Produto de teste) contém um conjunto de dados de API chamado **AWS Data Exchange de APIs (Produto de teste)** que está na região Leste dos EUA (Norte da Virgínia).

**Topics**
+ [Inscrevendo-se AWS Data Exchange para APIs (produto de teste)](subscribe-to-API-test-product.md)
+ [Visualizar a API](tutorial-view-api.md)
+ [Fazer download da especificação da API](tutorial-download-api-spec.md)
+ [Fazer uma chamada de API](tutorial-make-api-call-console.md)

# Inscrevendo-se AWS Data Exchange para APIs (produto de teste) em AWS Data Exchange
<a name="subscribe-to-API-test-product"></a>

O procedimento a seguir mostra como navegar no AWS Data Exchange catálogo para encontrar e assinar o AWS Data Exchange APIs (Produto de teste).

**Para encontrar e assinar o AWS Data Exchange APIs (produto de teste)**

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

1. Na barra de pesquisa, digite **AWS Data Exchange for APIs** e pressione **Enter**. 

1. Escolha o **AWS Data Exchange para APIs (Produto de teste)** e veja sua página de detalhes.

   1. **(Opcional) Para baixar a amostra, escolha a guia **Dicionário de dados e amostras**, escolha o botão de opção ao lado do nome da amostra (**ADX para APIs sample.json**) e escolha Baixar.**

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

1. Selecione a **Oferta do produto**.
**nota**  
AWS Data Exchange for APIs (Test Product) é um produto gratuito.

1. Analise os **Termos da assinatura**, os **Conjuntos de dados** e as **Informações de suporte**.

1. Escolha se deseja ativar a **Renovação automática da oferta** da assinatura. 
**nota**  
AWS Data Exchange for APIs (Produto de teste) não exige verificação de assinatura, mas alguns produtos exigem. Para obter mais informações, consulte [Verificação de assinatura para assinantes em AWS Data Exchange](subscription-verification-sub.md).

1. Escolha **Assinar**.

Pode levar alguns minutos para que a assinatura fique ativa depois de selecionar **Assinar**. Sair dessa página antes que sua assinatura se torne ativa não impedirá o processamento da assinatura. 

# Visualizando a AWS Data Exchange API
<a name="tutorial-view-api"></a>

Você pode visualizar a API com AWS Data Exchange for APIs (Test Product) usando as etapas a seguir.

**Para visualizar a 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 o produto intitulado ****AWS Data Exchange**para APIs (Produto de teste)** e, em seguida, escolha o conjunto APIs de dados **AWS Data Exchange para**.

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.

# Baixando a especificação AWS Data Exchange da API
<a name="tutorial-download-api-spec"></a>

Você pode baixar a especificação da API com AWS Data Exchange for APIs (Test Product) usando as etapas a seguir.

**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 o produto intitulado ****AWS Data Exchange**para APIs (Produto de teste)** e, em seguida, escolha o conjunto APIs de dados **AWS Data Exchange para**.

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.

# Fazendo uma chamada AWS Data Exchange de API
<a name="tutorial-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 o produto intitulado ****AWS Data Exchange**para APIs (Produto de teste)** e, em seguida, escolha o conjunto APIs de dados **AWS Data Exchange para**.

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

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

   Você verá o exemplo de **estrutura de código** e a **especificação OpenApi 3.0** para estruturar sua solicitação de API, que você pode usar AWS Command Line Interface para chamar a API. 

1. Em **Notas de integração**, selecione **Copiar** para copiar a **Estrutura do código** e, em seguida, colá-la na AWS CLI.

1. Substitua os valores de amostra pelos pares de valores-chave de parâmetro necessários usando as informações na documentação de especificação.

   A seguir está um exemplo de solicitação de API **AWS Data Exchange para APIs (Produto de teste)**.

   ```
   aws dataexchange send-api-asset \
     --data-set-id 8d494cba5e4720e5f6072e280daf70a8 \
     --revision-id b655d5be3da04fcbdca21a5a2932d789 \
     --asset-id 8550cfab16b444a794402f2c3f11eae1 \
     --method POST \
     --path "someresource" \
     --query-string-parameters 'param1=value1,param2=value2' \
     --request-headers 'header=header_value' \
     --body "{\"body_param\":\"body_param_value\"}"
   ```