REST-API im Amazon API Gateway aufrufen - Amazon API Gateway

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.

REST-API im Amazon API Gateway aufrufen

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://restapi_id.execute-api.region.amazonaws.com/stage_name/

wobei restapi_id die API-ID, Region die AWS Region und stage_name der Stufenname der API-Bereitstellung ist.

Wichtig

Bevor Sie eine API aufrufen können, müssen Sie sie in API Gateway bereitstellen. Anweisungen zum Bereitstellen einer API finden Sie unter Bereitstellen einer REST-API in Amazon API Gateway.

Abrufen der Aufruf-URL einer API

Sie können die Konsole, die oder eine exportierte OpenAPI-Definition verwenden AWS CLI, um die Aufruf-URL einer API abzurufen.

Abrufen der Aufruf-URL einer API mit der Konsole

Das folgende Verfahren zeigt, wie Sie die Aufruf-URL einer API in der REST-API-Konsole abrufen.

So rufen Sie die Aufruf-URL einer API mit der REST-API-Konsole ab
  1. Melden Sie sich bei der API-Gateway-Konsole unter https://console.aws.amazon.com/apigateway an.

  2. Wählen Sie eine bereitgestellte API aus.

  3. Wählen Sie im Haupt-Navigationsbereich Stufe aus.

  4. Wählen Sie unter Stufendetails das Kopiersymbol aus, um die Aufruf-URL Ihrer API zu kopieren.

    Diese URL bezieht sich auf die Stammressource Ihrer API.

    
                Nachdem Sie Ihre REST-API erstellt haben, zeigt die Konsole die Aufruf-URL Ihrer API an.
  5. Um die Aufruf-URL einer API für eine andere Ressource in Ihrer API abzurufen, erweitern Sie die Stufe im sekundären Navigationsbereich und wählen Sie dann eine Methode aus.

  6. Wählen Sie das Kopiersymbol, um die Aufruf-URL Ihrer API auf Ressourcenebene zu kopieren.

    
              Nachdem Sie die Stufe im sekundären Navigationsbereich erweitert haben, zeigt die Konsole die Aufruf-URL Ihrer API auf Ressourcenebene an.

Abrufen der Aufruf-URL einer API mit der AWS CLI

Das folgende Verfahren zeigt, wie Sie die Aufruf-URL einer API mithilfe der abrufen AWS CLI.

So rufen Sie die Aufruf-URL einer API mit der ab AWS CLI
  1. Verwenden Sie den folgenden Befehl, um die abzurufenrest-api-id. Dieser Befehl gibt alle rest-api-id Werte in Ihrer Region zurück. Weitere Informationen finden Sie unter get-rest-apis.

    aws apigateway get-rest-apis
  2. Ersetzen Sie das Beispiel rest-api-id durch Ihr rest-api-id, ersetzen Sie das Beispiel {stage-name} durch Ihr {stage-name} und ersetzen Sie {region} 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 Stamm-URL auch erstellen, indem Sie die basePath Felder host und einer exportierten OpenAPI-Definitionsdatei der API kombinieren. Anweisungen zum Exportieren Ihrer API finden Sie unter REST-API von API Gateway importieren.

Aufrufen einer API

Sie können Ihre bereitgestellte API über den Browser, curl oder andere Anwendungen wie Postman aufrufen.

Darüber hinaus können Sie die API Gateway-Konsole verwenden, um einen API-Aufruf zu testen. Test verwendet die API Gateway-TestInvokeFunktion, die API-Tests ermöglicht, bevor die API bereitgestellt wird. Weitere Informationen finden Sie unter API Gateway-Konsole zum Testen einer REST-API-Methode verwenden.

Anmerkung

In Parameterwerten für Abfragezeichenfolgen in einer Aufruf-URL ist %% nicht zulässig.

Aufrufen einer API über einen Webbrowser

Wenn Ihre API anonymen Zugriff zulässt, können Sie einen beliebigen Webbrowser verwenden, um eine beliebige GET Methode aufzurufen. Geben Sie die URL des vollständigen Aufrufs in die Adressleiste des Browsers ein.

Für andere Methoden oder alle für die Authentifizierung erforderlichen Aufrufe müssen Sie eine Nutzlast angeben oder die Anforderungen signieren. Sie können diese in einem Skript hinter einer HTML-Seite oder in einer Clientanwendung mithilfe eines der AWS SDKs verarbeiten.

Aufrufen einer API mit curl

Sie können ein Tool wie curl in Ihrem Terminal verwenden, um Ihre API aufzurufen. Der folgende Beispielbefehl curl ruft die GET-Methode für die -getUsersRessource der -prodStufe 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"