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. # Entwickeln Sie REST APIs in API Gateway In Amazon API Gateway erstellen Sie eine REST-API als eine Sammlung programmierbarer Entitäten, die als API Gateway-[Ressourcen](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) bekannt ist. Sie verwenden beispielsweise eine [RestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_RestApi.html)Ressource, um eine API darzustellen, die eine Sammlung von [Ressourcenentitäten](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) enthalten kann. Jede `Resource`-Entität kann über eine oder mehrere [Methoden](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html)-Ressourcen verfügen. Eine `Method` ist eine eingehende Anfrage, die vom Client übermittelt wird, und kann die folgenden Anfrageparameter enthalten: einen Pfadparameter, einen Header oder einen Abfragezeichenfolgenparameter. Zusätzlich kann die Anfrage, abhängig von der HTTP-Methode, einen Body enthalten. Die Methode definiert, wie der Client auf die exponierte `Resource` zugreift. Erstellen Sie eine Ressource unter [Integration](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html), um die `Method` mit einem Backend-Endpunkt (auch als Integrationsendpunkt bekannt) zu integrieren. Dadurch wird die eingehende Anforderung an eine bestimmte Integrationsendpunkt-URI weitergeleitet. Falls erforderlich, können Sie Anfrageparameter oder den Anfrage-Body transformieren, um die Anforderungen des Backends zu erfüllen, oder Sie erstellen eine Proxyintegration, bei der API Gateway die gesamte Anfrage in einem standardisierten Format an die Integrationsendpunkt-URI sendet und anschließend die Antwort direkt an den Client weiterleitet. Für Antworten können Sie eine [MethodResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_MethodResponse.html)Ressource erstellen, die eine vom Client empfangene Antwort darstellt, und Sie können eine [IntegrationResponse](https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html)Ressource erstellen, die die Antwort darstellt, die vom Backend zurückgegeben wird. Verwenden Sie eine Integrationsantwort, um die Backend-Antwortdaten zu transformieren, bevor die Daten an den Client zurückgegeben werden, oder um die Backend-Antwort unverändert an den Client zu übermitteln. ## Beispielressource für eine REST-API Das folgende Diagramm zeigt, wie API Gateway dieses request/response Modell für einen HTTP-Proxy und eine HTTP-Nicht-Proxy-Integration für die `GET /pets` Ressource implementiert. Der Client sendet den Header `x-version:beta` an API Gateway und API Gateway sendet den Statuscode `204` an den Client. In der Nicht-Proxy-Integration führt API Gateway Datentransformationen durch, um die Backend-Anforderungen zu erfüllen, indem die Integrationsanfrage und die Integrationsantwort angepasst werden. Bei einer Nicht-Proxy-Integration können Sie auf den Body in der Methodenanforderung zugreifen, jedoch transformieren Sie ihn in der Integrationsanforderung. Wenn der Integrationsendpunkt eine Antwort mit einem Body zurückgibt, greifen Sie in der Integrationsantwort darauf zu und transformieren ihn. Sie können den Body in der Methodenantwort nicht ändern. Bei der Proxyintegration ändert der Integrationsendpunkt die Anfrage und Antwort. API Gateway verändert weder die Integrationsanfrage noch die Integrationsantwort und sendet die eingehende Anfrage unverändert an das Backend. Unabhängig vom Integrationstyp hat der Client eine Anfrage an API Gateway gesendet und API Gateway hat synchron geantwortet. ------ #### [ Non-proxy integration ] ![\[Diagramm der Nicht-Proxy-Integration des API Gateway\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/develop-non-proxy.png) ------ #### [ Proxy integration ] ![\[Diagramm der Proxy-Integration des API Gateway\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/develop-proxy.png) ------ Die folgenden Beispielausführungsprotokolle zeigen, was API Gateway im vorherigen Beispiel protokollieren würde. Zur besseren Übersicht wurden einige Werte und erste Protokolle entfernt: ------ #### [ Non-proxy integration ] ``` Wed Feb 12 23:56:44 UTC 2025 : Starting execution for request: abcd-1234-5678 Wed Feb 12 23:56:44 UTC 2025 : HTTP Method: GET, Resource Path: /pets Wed Feb 12 23:56:44 UTC 2025 : Method request path: {} Wed Feb 12 23:56:44 UTC 2025 : Method request query string: {} Wed Feb 12 23:56:44 UTC 2025 : Method request headers: {x-version=beta} Wed Feb 12 23:56:44 UTC 2025 : Method request body before transformations: Wed Feb 12 23:56:44 UTC 2025 : Endpoint request URI: http://petstore-demo-endpoint.execute-api.com/petstore/pets Wed Feb 12 23:56:44 UTC 2025 : Endpoint request headers: {app-version=beta} Wed Feb 12 23:56:44 UTC 2025 : Endpoint request body after transformations: Wed Feb 12 23:56:44 UTC 2025 : Sending request to http://petstore-demo-endpoint.execute-api.com/petstore/pets Wed Feb 12 23:56:45 UTC 2025 : Received response. Status: 200, Integration latency: 123 ms Wed Feb 12 23:56:45 UTC 2025 : Endpoint response headers: {Date=Wed, 12 Feb 2025 23:56:45 GMT} Wed Feb 12 23:56:45 UTC 2025 : Endpoint response body before transformations: Wed Feb 12 23:56:45 UTC 2025 : Method response body after transformations: (null) Wed Feb 12 23:56:45 UTC 2025 : Method response headers: {X-Amzn-Trace-Id=Root=1-abcd-12345} Wed Feb 12 23:56:45 UTC 2025 : Successfully completed execution Wed Feb 12 23:56:45 UTC 2025 : Method completed with status: 204 ``` ------ #### [ Proxy integration ] ``` Wed Feb 12 23:59:42 UTC 2025 : Starting execution for request: abcd-1234-5678 Wed Feb 12 23:59:42 UTC 2025 : HTTP Method: GET, Resource Path: /pets Wed Feb 12 23:59:42 UTC 2025 : Method request path: {} Wed Feb 12 23:59:42 UTC 2025 : Method request query string: {} Wed Feb 12 23:59:42 UTC 2025 : Method request headers: {x-version=beta} Wed Feb 12 23:59:42 UTC 2025 : Method request body before transformations: Wed Feb 12 23:59:42 UTC 2025 : Endpoint request URI: http://petstore-demo-endpoint.execute-api.com/petstore/pets Wed Feb 12 23:59:42 UTC 2025 : Endpoint request headers: { x-version=beta} Wed Feb 12 23:59:42 UTC 2025 : Endpoint request body after transformations: Wed Feb 12 23:59:42 UTC 2025 : Sending request to http://petstore-demo-endpoint.execute-api.com/petstore/pets Wed Feb 12 23:59:43 UTC 2025 : Received response. Status: 204, Integration latency: 123 ms Wed Feb 12 23:59:43 UTC 2025 : Endpoint response headers: {Date=Wed, 12 Feb 2025 23:59:43 GMT} Wed Feb 12 23:59:43 UTC 2025 : Endpoint response body before transformations: Wed Feb 12 23:59:43 UTC 2025 : Method response body after transformations: Wed Feb 12 23:59:43 UTC 2025 : Method response headers: {Date=Wed, 12 Feb 2025 23:59:43 GMT} Wed Feb 12 23:59:43 UTC 2025 : Successfully completed execution Wed Feb 12 23:59:43 UTC 2025 : Method completed with status: 204 ``` ------ Informationen zum Importieren einer ähnlichen API und zum Testen in der AWS-Managementkonsole finden Sie in der [Beispiel-API](api-gateway-create-api-from-example.md). ## Zusätzliche REST-API-Features für die Entwicklung API Gateway unterstützt zusätzliche Features für die Entwicklung Ihrer REST-API. Zum Beispiel können Sie, um Ihren Kunden das Verständnis Ihrer API zu erleichtern, Dokumentation für die API bereitstellen. Um dies zu erreichen, fügen Sie eine [DocumentationPart](https://docs.aws.amazon.com/apigateway/latest/api/API_DocumentationPart.html)-Ressource für eine unterstützte API-Entität hinzu. Um zu steuern, wie Clients eine API aufrufen, verwenden Sie [IAM-Berechtigungen](permissions.md), einen [Lambda-Genehmiger](apigateway-use-lambda-authorizer.md) oder einen [Amazon Cognito-Benutzerpool](apigateway-integrate-with-cognito.md). Um die Nutzung Ihrer API zu messen, richten Sie [Nutzungspläne](api-gateway-api-usage-plans.md) ein, um die API-Anforderungen zu drosseln. Diese aktivieren Sie beim Erstellen oder Aktualisieren der API. Das folgende Diagramm zeigt die Features, die für die REST-API-Entwicklung verfügbar sind, und an welcher Stelle im Anfrage-/Antwortmodell diese Features konfiguriert werden. ![\[Diagramm der API-Gateway-Features\]](http://docs.aws.amazon.com/de_de/apigateway/latest/developerguide/images/develop-features.png) Eine Einführung in die Erstellung einer API finden Sie unter [Tutorial: Erstellen einer REST-API mit einer Lambda-Proxy-Integration](api-gateway-create-api-as-simple-proxy-for-lambda.md). Weitere Informationen zu den Funktionen von API Gateway, die Sie bei der Entwicklung einer REST-API verwenden können, finden Sie in den nachfolgenden Themen. Diese Themen enthalten konzeptionelle Informationen und Verfahren, die Sie mithilfe der API Gateway Gateway-Konsole, der API Gateway Gateway-REST-API AWS CLI, der oder einer der folgenden ausführen können AWS SDKs. **Topics** + [Beispielressource für eine REST-API](#rest-api-develop-example) + [Zusätzliche REST-API-Features für die Entwicklung](#rest-api-develop-details) + [API-Endpunkttypen für REST APIs in API Gateway](api-gateway-api-endpoint-types.md) + [Sicherheitsrichtlinien für REST APIs in API Gateway](apigateway-security-policies.md) + [IP-Adresstypen für REST-APIs in API Gateway](api-gateway-ip-address-type.md) + [Methoden für REST APIs in API Gateway](how-to-method-settings.md) + [Steuern und verwalten Sie den Zugriff auf REST APIs in API Gateway](apigateway-control-access-to-api.md) + [Integrationen für REST APIs in API Gateway](how-to-integration-settings.md) + [Validierung für REST APIs in API Gateway anfordern](api-gateway-method-request-validation.md) + [Datentransformationen für REST APIs in API Gateway](rest-api-data-transformations.md) + [Gateway-Antworten für REST APIs in API Gateway](api-gateway-gatewayResponse-definition.md) + [CORS für REST APIs im API Gateway](how-to-cors.md) + [Binäre Medientypen für REST APIs in API Gateway](api-gateway-payload-encodings.md) + [Aufrufen von REST-APIs in API Gateway](how-to-call-api.md) + [Entwickeln APIs Sie REST mit OpenAPI in API Gateway](api-gateway-import-api.md)