Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Aufrufen von REST-APIs in API Gateway
Um eine bereitgestellte API aufzurufen, senden Kunden Anfragen an die URL für den API Gateway-Komponenten-Service zur API-Ausführung (bekannt als `execute-api`).
Die Basis-URL für REST-API liegt im folgenden Format vor:
```
https://api-id.execute-api.region.amazonaws.com/stage/
```
wobei *api-id* die API-Kennung, *region* die AWS-Region und *stage* der Stufenname der API-Bereitstellung ist.
**Wichtig**
Bevor Sie eine API aufrufen können, müssen Sie sie in API Gateway bereitstellen. Anleitungen zur Bereitstellung einer API finden Sie unter [REST-APIs in API Gateway bereitstellen](how-to-deploy-api.md).
**Topics**
+ [Die Aufruf-URL einer API abrufen](#apigateway-how-to-call-rest-api)
+ [Aufrufen einer API](#apigateway-call-api)
+ [API Gateway-Konsole zum Testen einer REST-API-Methode verwenden](how-to-test-method.md)
+ [Von API Gateway generiertes Java-SDK für eine REST-API verwenden](how-to-call-apigateway-generated-java-sdk.md)
+ [Ein von API Gateway generiertes Android-SDK für eine REST-API verwenden](how-to-generate-sdk-android.md)
+ [Verwenden Sie ein von API Gateway generiertes JavaScript SDK für eine REST-API](how-to-generate-sdk-javascript.md)
+ [Ein von API Gateway generiertes Ruby-SDK für eine REST-API verwenden](how-to-call-sdk-ruby.md)
+ [Von API Gateway generiertes iOS-SDK für eine REST-API in Objective-C oder Swift verwenden](how-to-generate-sdk-ios.md)
## Die Aufruf-URL einer API abrufen
Sie können die Konsole, AWS CLI oder eine exportierte OpenAPI-Definition verwenden, um die Aufruf-URL einer API abzurufen.
### Die Aufruf-URL einer API in der Konsole abrufen
Im folgenden Verfahren wird gezeigt, wie Sie die Aufruf-URL einer API in der REST-API-Konsole abrufen.
**Abrufen der Aufruf-URL einer API in der REST-API-Konsole**
1. Melden Sie sich bei der API Gateway-Konsole unter [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway) an.
1. Wählen Sie eine bereitgestellte API aus.
1. Wählen Sie im Haupt-Navigationsbereich **Stufe** aus.
1. Wählen Sie unter **Stufendetails** das Kopiersymbol aus, um die Aufruf-URL Ihrer API zu kopieren.
Diese URL ist für die Root-Ressource Ihrer API.
![\[Nachdem Sie Ihre REST-API erstellt haben, zeigt die Konsole die Aufruf-URL Ihrer API an.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/getting-started-rest-invoke-url.png)
1. Vergrößern Sie die Stufe im sekundären Navigationsbereich und wählen Sie dann eine Methode aus, um die Aufruf-URL einer API für eine andere Ressource in Ihrer API abzurufen.
1. Klicken Sie auf das Kopiersymbol, um die Aufruf-URL Ihrer API auf Ressourcenebene zu kopieren.
![\[Die URL auf Ressourcenebene Ihrer REST-API befindet sich im sekundären Navigationsbereich der Stufe.\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/resource-level-invoke-url.png)
#### Aufruf-URL einer API mithilfe der AWS CLI abrufen
Im folgenden Verfahren wird gezeigt, wie Sie die Aufruf-URL einer API mithilfe der AWS CLI abrufen.
**Aufruf-URL einer API mithilfe der AWS CLI abrufen**
1. Rufen Sie die `rest-api-id` mit folgendem Befehl ab. Dieser Befehl gibt alle `rest-api-id`-Werte in Ihrer Region zurück. Weitere Informationen finden Sie unter [get-rest-apis](https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-rest-apis.html).
```
aws apigateway get-rest-apis
```
1. Ersetzen Sie die Beispiel-`rest-api-id` durch Ihre `rest-api-id`, den Beispiel-*\$1stage-name\$1* durch Ihren *\$1stage-name\$1* und die *\$1region\$1* durch Ihre Region.
```
https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}/
```
##### Abrufen der Aufruf-URL einer API mithilfe der exportierten OpenAPI-Definitionsdatei der API
Sie können die Root-URL auch zusammensetzen, indem Sie die Felder `host` und `basePath` einer exportierten OpenAPI-Definitionsdatei der API kombinieren. Eine Anleitung zum Exportieren Ihrer API finden Sie unter [REST-API von API Gateway importieren](api-gateway-export-api.md).
## Aufrufen einer API
Sie können Ihre bereitgestellte API im Browser, mit Curl oder anderen Anwendungen wie [Postman](https://www.postman.com/) aufrufen.
Darüber hinaus können Sie einen API-Aufruf mithilfe der API-Gateway-Konsole testen. Der Test verwendet die `TestInvoke`-Funktion des API-Gateways, die API-Tests vor der Bereitstellung der API ermöglicht. Weitere Informationen finden Sie unter [API Gateway-Konsole zum Testen einer REST-API-Methode verwenden](how-to-test-method.md).
**Anmerkung**
In Parameterwerten für Abfragezeichenfolgen in einer Aufruf-URL ist `%%` nicht zulässig.
### Aufrufen einer API mit einem Webbrowser
Wenn Ihre API anonyme Zugriffe gestattet, können Sie jeden Webbrowser verwenden, um eine beliebige `GET`-Methode aufzurufen. Geben Sie die vollständige Aufruf-URL in die Adressleiste des Browsers ein.
Bei anderen Methoden oder Aufrufen, für die eine Authentifizierung erforderlich ist, müssen Sie eine Nutzlast angeben oder die Anforderungen signieren. Sie können diese mithilfe eines der AWS-SDKs in einem Skript hinter einer HTML-Seite oder in einer Client-Anwendung verarbeiten.
#### Aufrufen einer API mit Curl
Sie können ein Tool wie [Curl](https://curl.se/) in Ihrem Terminal verwenden, um Ihre API aufzurufen. Der folgende CURL-Beispielbefehl ruft die GET-Methode für die `getUsers`-Ressource in der `prod`-Stufe einer API auf.
------
#### [ Linux or Macintosh ]
```
curl -X GET 'https://b123abcde4.execute-api.us-west-2.amazonaws.com/prod/getUsers'
```
------
#### [ Windows ]
```
curl -X GET "https://b123abcde4.execute-api.us-west-2.amazonaws.com/prod/getUsers"
```
------