# Exporter une définition d'API

Afin d'exporter une définition d'API depuis Talend Cloud API Designer, utilisez la méthode GET sur l'endpoint /api-definitions/{id}.

Pour des cas d'usage utilisant cette requête, consultez [Exemples d'utilisation de Talend Cloud API Designer](https://help.qlik.com/talend/fr-FR/api-designer-user-guide/Cloud/api-designer-examples).

## Avant de commencer

* Vous avez une API dans Talend Cloud API Designer.
* Vous avez généré un jeton d'accès personnel. Pour plus d'informations, consultez [Générer un jeton d'accès personnel](https://help.qlik.com/talend/r/fr-FR/Cloud/management-console-user-guide/cloud-access-token).

## Procédure

1. Ouvrez Talend Cloud API Tester et créez une requête.
2. Conserver la méthode GET sélectionnée par défaut, puis saisissez l'URI ci-dessous avec les paramètres appropriés :

   https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}
   | Paramètre | Description |
   | --- | --- |
   | {region} | Région de votre compte Talend Cloud. La valeur peut être :<br><br><ul> <li> <span>us-west</span> </li> <li> <span>us</span> </li> <li> <span>eu</span> </li> <li> <span>ap</span> </li> <li> <span>au</span> </li> </ul><br><br>Pour plus d'informations, consultez [Accéder aux applications Talend Cloud](https://help.qlik.com/talend/fr-FR/installation-guide-windows/Cloud/talend-cloud-application-url). |
   | {api-id} | ID de la version de l'API à récupérer. Pour le récupérer, ouvrez votre API dans Talend Cloud API Designer et allez dans Settings &gt; MANAGEMENT API ou utilisez la méthode GET sur l'endpoint /api-definitions pour obtenir une liste de définitions d'API avec leur ID. |
3. Facultatif : Développez QUERY PARAMETERS et cliquez sur Add query parameters.

   Les paramètres disponibles sont les suivants :
   | Paramètre | Description |
   | --- | --- |
   | format | Format dans lequel vous souhaitez exporter votre définition. La valeur peut être :<br><br><ul> <li> <kbd>OpenApi3</kbd> (valeur par défaut)</li> <li> <kbd>Swagger20</kbd> </li> <li> <kbd>Swagger12</kbd> </li> <li> <kbd>Raml10</kbd> </li> <li> <kbd>Raml08</kbd> </li> <li> <kbd>OpenApi3Aws</kbd> (format compatible avec AWS API Gateway)</li> <li> <kbd>Swagger20Azure</kbd> (format compatible avec Azure API Management)</li> </ul> |
   | talendExtensions | Indique si vous souhaitez que vôtre définition exportée contienne des extensions ou des annotations Talend. Sa valeur peut être true ou false. La valeur par défaut est false.<br><br>Note InformationsRemarque : Les extensions Talend ne sont compatibles ni avec AWS API Gateway, ni avec Azure API Management. Si vous avez saisi OpenApi3AWS ou Swagger20Azure dans le paramètre format, ce paramètre-ci est ignoré. |
4. Cliquez sur le bouton Add header, saisissez Authorization dans le champ name et Bearer suivi d'un espace, puis de votre jeton, dans le champ value.

   Note InformationsConseil : Dans Talend Cloud API Tester, vous pouvez ajouter votre jeton comme variable d'environnement privée et y faire référence dans vos requêtes, à l'aide de l'Expression Builder. Pour plus d'informations, consultez [Utiliser des environnements](https://help.qlik.com/talend/r/fr-FR/Cloud/api-tester-user-guide/using-environments).
5. Une fois votre requête configurée, cliquez sur Send.
   ### Exemple

   ![Dans Talend Cloud API Tester, la requête est configurée.](https://help.qlik.com/talend/fr-FR/api-user-guide/Resources/images/export_api_definition_1_configured_request.png)

## Résultats

Talend Cloud API Tester renvoie une réponse contenant la définition de l'API dans le format sélectionné. Vous pouvez alors cliquer sur le bouton Download situé en bas de page afin de l'enregistrer. ![Bouton Download (Télécharger) en bas à droite de la page.](https://help.qlik.com/talend/fr-FR/api-user-guide/Resources/images/export_response.png)