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.

# AWS Data Exchange pour APIs (produit de test)
<a name="subscriber-tutorial-api-product"></a>

AWS Data Exchange for APIs (Test Product) est un produit gratuit mis à la disposition des abonnés pour leur permettre de comprendre comment interagir avec un AWS Data Exchange produit contenant des ensembles de données d'API. Vous pouvez utiliser ce produit à des fins de test et pour apprendre à effectuer des appels d'API aux fournisseurs afin de récupérer des données basées sur des API.

AWS Data Exchange for APIs (Test Product) contient un ensemble de données API nommé **AWS Data Exchange d'après APIs (Test Product)** situé dans la région USA Est (Virginie du Nord).

**Topics**
+ [S'abonner à AWS Data Exchange for APIs (Test Product)](subscribe-to-API-test-product.md)
+ [Affichage de l'API](tutorial-view-api.md)
+ [Téléchargement de la spécification de l'API](tutorial-download-api-spec.md)
+ [Effectuer un appel d'API](tutorial-make-api-call-console.md)

# S'abonner à AWS Data Exchange for APIs (Test Product) sur AWS Data Exchange
<a name="subscribe-to-API-test-product"></a>

La procédure suivante indique comment parcourir le AWS Data Exchange catalogue pour rechercher APIs (produit test) et s' AWS Data Exchange y abonner.

**Pour trouver et s'abonner AWS Data Exchange à APIs (Test Product)**

1. Ouvrez la [AWS Data Exchange console et connectez-vous à celle-ci](https://console.aws.amazon.com/dataexchange).

1. Dans le volet de navigation de gauche, sous **Découvrir les produits de données**, sélectionnez **Parcourir le catalogue**.

1. Dans la barre de recherche, entrez **AWS Data Exchange for APIs** et appuyez sur **Entrée**. 

1. Choisissez le **AWS Data Exchange pour APIs (produit de test)** et consultez sa page de détails.

   1. **(Facultatif) Pour télécharger l'exemple, choisissez l'onglet **Dictionnaire de données et exemples**, cliquez sur le bouton d'option à côté du nom de l'échantillon (**ADX pour APIs sample.json**), puis choisissez Télécharger.**

1. Dans le coin supérieur droit, choisissez **Continuer pour vous abonner**. 

1. Choisissez l'**offre de produit**.
**Note**  
AWS Data Exchange for APIs (Test Product) est un produit gratuit.

1. Consultez les **conditions d'abonnement**, **les ensembles de données** et les **informations de support**.

1. Choisissez d'activer ou non le **renouvellement automatique de l'offre** pour l'abonnement. 
**Note**  
AWS Data Exchange for APIs (Test Product) ne nécessite pas de vérification d'abonnement, mais certains produits le font. Pour de plus amples informations, veuillez consulter [Vérification de l'abonnement pour les abonnés de AWS Data Exchange](subscription-verification-sub.md).

1. Choisissez **Abonner**.

L'activation de votre abonnement peut prendre quelques minutes une fois que vous avez sélectionné S'**abonner**. Le fait de quitter cette page avant que votre abonnement ne soit actif n'empêchera pas le traitement de l'abonnement. 

# Affichage de l' AWS Data Exchange API
<a name="tutorial-view-api"></a>

Vous pouvez consulter l'API avec AWS Data Exchange for APIs (Test Product) en suivant les étapes suivantes.

**Pour consulter l'API**

1. Ouvrez la [AWS Data Exchange console et connectez-vous à celle-ci](https://console.aws.amazon.com/dataexchange).

1. Dans le volet de navigation de gauche, sous **Mes abonnements**, sélectionnez **Données autorisées**.

1. Choisissez le produit intitulé ****AWS Data Exchange**pour APIs (Produit de test)**, puis choisissez le jeu de APIs données **AWS Data Exchange pour**.

1. Dans l'onglet **Révisions**, choisissez une révision.

1. Sous **Ressources d'API**, choisissez l'API.

1. Consultez la vue **d'ensemble des actifs**.

1. Suivez les instructions contenues dans les **notes d'intégration** pour appeler l'API.

# Téléchargement de la spécification de AWS Data Exchange l'API
<a name="tutorial-download-api-spec"></a>

Vous pouvez télécharger la spécification de l'API avec AWS Data Exchange for APIs (Test Product) en suivant les étapes suivantes.

**Pour télécharger la spécification de l'API**

1. Ouvrez la [AWS Data Exchange console et connectez-vous à celle-ci](https://console.aws.amazon.com/dataexchange).

1. Dans le volet de navigation de gauche, sous **Mes abonnements**, sélectionnez **Données autorisées**.

1. Choisissez le produit intitulé ****AWS Data Exchange**pour APIs (Produit de test)**, puis choisissez le jeu de APIs données **AWS Data Exchange pour**.

1. Dans l'onglet **Révisions**, choisissez une révision.

1. Sous **Ressources d'API**, choisissez l'API.

1. Dans la spécification **OpenAPI 3.0, choisissez Télécharger la spécification** **de l'API**.

   La spécification est téléchargée sur votre ordinateur local. Vous pouvez ensuite exporter la ressource vers un outil tiers pour générer un SDK.

# Effectuer un appel AWS Data Exchange d'API
<a name="tutorial-make-api-call-console"></a>

Vous pouvez appeler un seul point de terminaison dans la AWS Data Exchange console.

**Pour effectuer un appel d'API depuis la console**

1. Ouvrez la [AWS Data Exchange console et connectez-vous à celle-ci](https://console.aws.amazon.com/dataexchange).

1. Dans le volet de navigation de gauche, sous **Mes abonnements**, sélectionnez **Données autorisées**.

1. Choisissez le produit intitulé ****AWS Data Exchange**pour APIs (Produit de test)**, puis choisissez le jeu de APIs données **AWS Data Exchange pour**.

1. Dans l'onglet **Révisions**, sélectionnez la révision.

1. Sous **Ressources d'API**, choisissez l'API.

   Vous verrez l'exemple de **structure de code et la** **spécification OpenApi 3.0** pour structurer votre demande d'API, que vous pouvez utiliser AWS Command Line Interface pour appeler l'API. 

1. Sous **Notes d'intégration**, choisissez **Copier** pour copier la **structure du code**, puis collez-la dans le AWS CLI.

1. Remplacez les valeurs d'échantillon par les paires clé-valeur de paramètres dont vous avez besoin à l'aide des informations contenues dans la documentation des spécifications.

   Vous trouverez ci-dessous un exemple de demande d'API **AWS Data Exchange pour APIs (produit de test)**.

   ```
   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\"}"
   ```