Creación de una API REST en Amazon API Gateway - Amazon API Gateway

Creación de una API REST en Amazon API Gateway

En Amazon API Gateway, las API REST se crean como una colección de entidades programables conocidas como recursos de API Gateway. Por ejemplo, se utiliza un recurso RestApi para representar una API que puede contener una colección de entidades Resource. Cada entidad Resource a su vez puede tener uno o más recursos Method. Expresado en los parámetros de solicitud y en el cuerpo, un Method define la interfaz de programación de aplicaciones del cliente para obtener acceso al Resource expuesto y representa una solicitud entrante enviada por el cliente. A continuación, se crea un recurso Integration para integrar el Method con un punto de enlace de backend, también conocido como punto de enlace de integración, reenviando la solicitud entrante a un URI de punto de enlace de integración especificado. Si es necesario, puede transformar los parámetros de solicitud o el cuerpo para que cumplan los requisitos del backend. Para las respuestas, puede crear un recurso MethodResponse para representar una respuesta de solicitud recibida por el cliente y crear un recurso IntegrationResponse para representar la respuesta de solicitud que devuelve el backend. Puede configurar la respuesta de integración para transformar los datos de respuesta del backend antes de devolver los datos al cliente o transferir la respuesta del backend tal y como está al cliente.

Para ayudar a sus clientes a comprender su API, también puede proporcionar documentación para la API, como parte de la creación de la API o una vez que se ha creado. Para ello, agregue un recurso DocumentationPart para una entidad de API compatible.

Para controlar el modo en que los clientes llaman a la API, utilice permisos de IAM, un autorizador de Lambda o un grupo de usuarios de Amazon Cognito. Para medir el uso de la API, configure planes de uso para limitar las solicitudes a la API. Puede habilitar estos elementos al crear o al actualizar la API.

Puede realizar estas y otras tareas a través de la consola de API Gateway, la API REST de API Gateway, la AWS CLI o uno de los AWS SDK. A continuación, trataremos cómo realizar estas tareas.