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.
# Abonnement et accès à un AWS Data Exchange produit contenant APIs
Les rubriques suivantes décrivent le processus complet de souscription et d'accès à un produit contenant APIs un à l'aide AWS Data Exchange de la AWS Data Exchange console.
Pour plus d'informations sur la façon d'évaluer un produit avant de s'abonner, voir [Évaluer des produits contenant des dictionnaires de données et des exemples](subscriber-getting-started.md#evaluate-products).
Le processus comporte les étapes suivantes :
**Topics**
+ [Étape 1 : Abonnement à un produit contenant APIs](#subscribe-to-API-product)
+ [Étape 2 : Accès à un produit API](#use-API-product)
Pour vous entraîner à vous abonner à un produit contenant et à y accéder APIs, consultez le[AWS Data Exchange pour APIs (produit de test)](subscriber-tutorial-api-product.md).
## Étape 1 : Abonnement à un produit contenant APIs
Si vous vous abonnez à un produit payant, vous êtes facturé sur votre AWS facture. Vous avez accès à tous les ensembles de données autorisés. Pour de plus amples informations, veuillez consulter [Abonnement à des produits de AWS Data Exchange données sur AWS Data Exchange](subscribe-to-data-sets.md).
Un fournisseur peut inclure les coûts mesurés pour le produit qu'il contient APIs. Si un fournisseur réduit ses coûts mesurés, la baisse de prix entre en vigueur immédiatement. Si le fournisseur augmente les coûts mesurés et que vous êtes déjà abonné, l'augmentation de prix entre en vigueur le premier jour du mois, 90 jours après la soumission de l'augmentation de prix OU lors du renouvellement (selon la première éventualité). Un e-mail est envoyé aux abonnés existants lorsque le changement de prix est soumis.
**Example**
Supposons, par exemple, qu'un fournisseur soumette une augmentation de prix de revient mesurée le 10 mai. Les abonnés existants reçoivent un e-mail concernant le changement de prix. L'augmentation de prix entre en vigueur le 1er septembre.
**Pour vous abonner à un produit contenant APIs**
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**.
Pour plus d'informations, voir [Parcourir le catalogue](subscriber-getting-started.md#browse-catalog).
1. Sous **Affiner les résultats**, utilisez le filtre de **type d'ensemble de données** et sélectionnez **API** pour rechercher les produits contenant APIs.
Pour plus d'informations, voir [Parcourir le catalogue](subscriber-getting-started.md#browse-catalog).
1. Sélectionnez un produit contenant APIs et consultez sa page détaillée.
Les informations figurant sur la page détaillée du produit incluent une description du produit, les coordonnées du fournisseur et les détails de l'offre publique du produit. Les informations relatives à l'offre publique incluent le prix et les durées, les coûts mesurés (s'ils sont inclus), le contrat d'abonnement aux données (DSA) et la politique de remboursement. Vous pouvez consulter les noms des ensembles de données inclus dans le produit et ceux Régions AWS dans lesquels ils sont disponibles. Vous pouvez également continuer à parcourir les pages détaillées des autres produits en choisissant un produit sous **Produits similaires**.
Si le fournisseur a émis une offre personnalisée pour votre compte (par exemple, une [offre privée ou une offre](subscribe-to-private-offer.md) [Bring Your Own Subscription (BYOS)](subscribe-to-byos-offer.md)), ces informations s'affichent également.
1. Sous **Offre publique**, consultez les **coûts mesurés par l'API** (s'ils sont inclus).
1. (Facultatif) Dans le **calculateur de coûts mesurés**, choisissez **Sélectionner le coût mesuré**, puis entrez le nombre d'unités pour afficher un exemple du coût.
1. Dans le coin supérieur droit, choisissez **Continuer pour vous abonner**.
1. Choisissez votre combinaison de prix et de durée préférée, choisissez si vous souhaitez activer le renouvellement automatique de l'abonnement et consultez les détails de l'offre, y compris le DSA.
**Note**
Certains produits nécessitent une vérification d'abonnement. 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. **Consultez les informations tarifaires, choisissez l'offre tarifaire, puis choisissez S'abonner.**
**Note**
Si vous vous abonnez à un produit payant, vous êtes invité à confirmer votre décision de vous abonner.
1. Sous **Ensembles de données inclus dans votre abonnement**, consultez les **ensembles de données** répertoriés.
Une fois le traitement de l'abonnement terminé, vous pouvez choisir un ensemble de données pour accéder à vos données autorisées ou choisir **Afficher l'abonnement** pour consulter votre abonnement.
## Étape 2 : Accès à un produit API
Les rubriques suivantes fournissent des informations sur la manière d'accéder à un produit qui inclut des ensembles de données d'API :
**Topics**
+ [Afficher une API](#view-the-api)
+ [Téléchargement de la spécification de l'API](#download-api-spec)
+ [Effectuer un appel d'API (console)](#make-api-call-console)
+ [Effectuer un appel d'API (AWS CLI)](#make-api-call-cli)
### Afficher une API
**Pour consulter une 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 un ensemble de données.
1. Dans l'onglet **Révisions**, choisissez une révision.
1. Sous **Ressources d'API**, choisissez l'API.
1. Consultez l'**aperçu 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 l'API
**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 un ensemble de données.
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 d'API (console)
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 un ensemble de données.
1. Dans l'onglet **Révisions**, choisissez une révision.
1. Sous **Ressources d'API**, choisissez l'API.
1. Pour les **notes d'intégration** :
1. Choisissez **Copier** pour utiliser l'**URL de base**.
1. Choisissez **Copier** pour utiliser la **structure du code**.
1. Suivez les informations fournies dans la documentation des spécifications pour appeler l'API.
### Effectuer un appel d'API (AWS CLI)
**Pour effectuer un appel d'API (AWS CLI)**
+ Utilisez la `send-api-asset` commande pour appeler l'API.
```
$ AWS dataexchange send-api-asset \
--asset-id $ASSET_ID \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID \
--body "..." \
{
"headers": {
...
},
"body": "..."
}
```