# Abrufen der API-Dokumentation über die Management-API

Verwenden Sie die Management-API von Talend Cloud API Designer, um Ihre API-Definition im Inhaltsformat des API-Portals „API Portal Content“ abzurufen und in Ihrem Repository hinzuzufügen.

## Vorbereitungen

* Sie haben das Repository für Ihr Portal erstellt.
* Sie haben ein persönliches Zugriffstoken generiert. Weitere Informationen finden Sie unter „[Generieren persönlicher Zugriffstoken](https://help.qlik.com/talend/r/de-DE/Cloud/management-console-user-guide/cloud-access-token)“.

## Prozedur

1. Verwenden Sie den folgenden Befehl mit den relevanten Parametern, um die API im richtigen Format abzurufen:
   ```
   curl -X GET -H "Authorization:Bearer {userToken}" https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}?format=ApiPortalContent
   ```
   | Parameter | Wert |
   | --- | --- |
   | {userToken} | Über Talend Cloud generiertes Token. |
   | {region} | Region für Ihr Talend Cloud-Konto. Mögliche Werte:<br><br><ul> <li> <span>us-west</span> (USA Westen)                            </li> <li> <span>us</span> (USA)                            </li> <li> <span>eu</span> (Europa)                            </li> <li> <span>ap</span> (Asien-Pazifik)                            </li> <li> <span>au (Australien)</span> </li> </ul><br><br>Weitere Informationen finden Sie unter [Zugriff auf Talend Cloud-Anwendungen](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url?tr=de-DE). |
   | {api-id} | ID der abzurufenden API-Version. Sie finden die ID, wenn Sie Ihre API in Talend Cloud API Designer öffnen und Settings (Einstellungen) &gt; MANAGEMENT API (MANAGEMENT-API) aufrufen oder die GET-Methode am /api-definitions-Endpunkt vewenden. Dadurch wird eine Liste der API-Definitionen mit den zugehörigen IDs aufgerufen. |
2. Kopieren Sie die Antwort auf den Befehl.
3. Öffnen Sie im Repository Ihres API-Portals den Ordner apis.
4. Erstellen Sie in apis einen Ordner mit dem Namen der API und erstellen Sie darin einen neuen Ordner mit dem Namen der Version.
   ### Example

   Wenn Sie über eine API namens Contacts API in Version 4.0.0 verfügen, sieht die Ordnerstruktur folgendermaßen aus: /apis/contacts-api/4.0.0/.
5. Erstellen Sie eine Datei namens index.md im Versionsordner und fügen Sie die Antwort auf den Befehl in die Datei ein.
   ### Example

   ![Beispiel einer Datei index.md.](https://help.qlik.com/talend/de-DE/api-designer-user-guide/Resources/images/importing_api_reference_doc_01_indexmd.png)
6. Optional: Wenn Sie ebenfalls API-Definitionen bereitstellen möchten, die von Ihren Benutzern heruntergeladen werden können, verwenden Sie denselben Befehl mit dem Format OpenApi3 oder Swagger20. Speichern Sie dann den Antwortinhalt als openapi30.json oder swagger20.json im gleichen Ordner wie die Dokumentation.
7. Übergeben Sie Ihre Änderungen.

## Ergebnisse

Die API-Dokumentation kann jetzt veröffentlicht werden. Sie können diese Schritte für alle anderen APIs wiederholen, die Sie in Ihr Portal aufnehmen möchten.