Obtención de la URL de invocación de una API Invocación de una API

Invocación de una API REST en Amazon API Gateway

Para llamar a una API implementada, los clientes envían solicitudes a la URL del servicio del componente de API Gateway para la ejecución de API, denominado execute-api.

La URL base de las API de REST tiene el siguiente formato:


https://restapi_id.execute-api.region.amazonaws.com/stage_name/

donde restapi_id es el identificador de la API, region es la región de AWS y stage_name es el nombre de la etapa de la implementación de la API.

importante

Antes de poder invocar una API, debe implementarla en API Gateway. Para obtener instrucciones sobre cómo implementar una API, consulte Implementación de una API de REST en Amazon API Gateway.

Temas

Obtención de la URL de invocación de una API

Puede usar la consola, la AWS CLI o una definición de OpenAPI exportada para obtener la URL de invocación de una API.

Obtención de la URL de invocación de una API con la consola

En el siguiente procedimiento se muestra cómo obtener la URL de invocación de una API en la consola de la API de REST.

Obtención de la URL de invocación de una API con la consola de API de REST

Inicie sesión en la consola de API Gateway en https://console.aws.amazon.com/apigateway.
Elija una API implementada.
En el panel de navegación principal, elija Etapa.
En Detalles de la etapa, elija el icono de copia para copiar la URL de invocación de la API.

Esta URL es para el recurso raíz de la API.
Para obtener la URL de invocación de una API para otro recurso de la API, expanda la etapa bajo el panel de navegación secundario y, a continuación, elija un método.
Elija el icono de copiar para copiar la URL de invocación en el nivel de recursos de la API.

Obtención de la URL de invocación de una API con la AWS CLI

En el siguiente procedimiento se muestra cómo obtener la URL de invocación de una API con la AWS CLI.

Obtención de la URL de invocación de una API con la AWS CLI

Utilice el siguiente comando para obtener rest-api-id. Este comando devuelve todos los valores rest-api-id de la región. Para obtener más información, consulte get-rest-apis.
```
aws apigateway get-rest-apis
```
Sustituya rest-api-id del ejemplo por su rest-api-id, sustituya {stage-name} del ejemplo por su {stage-name} y sustituya {region} por su región.
```
https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}/
```

Obtención de la URL de invocación de una API mediante el archivo de definición de OpenAPI exportado de la API

También puede crear la URL raíz combinando los campos host y basePath de un archivo de definición de OpenAPI exportado de la API. Para obtener instrucciones acerca de cómo exportar la API, consulte Exportación de una API REST desde API Gateway.

Invocación de una API

Puede llamar a la API implementada mediante el navegador, curl u otras aplicaciones, como Postman.

Además, puede utilizar la consola de API Gateway para probar una llamada a la API. La prueba utiliza la característica TestInvoke de API Gateway, que permite probar la API antes de que se implemente la API. Para obtener más información, consulte Uso de la consola de API Gateway para probar un método de la API REST.

nota

Los valores de los parámetros de cadenas de consulta en una URL de invocación no pueden contener %%.

Invocación de una API mediante un navegador web

Si la API permite el acceso anónimo, puede utilizar cualquier navegador web para invocar cualquier método GET. Ingrese la URL de invocación completa en la barra de dirección del navegador.

Para otros métodos o para todas las llamadas que requieran autenticación, debe especificar una carga o firmar las solicitudes. Puede realizar esto en un script detrás de una página HTML o en una aplicación cliente mediante uno de los SDK de AWS.

Invocación de una API mediante curl

Puede usar una herramienta como curl en el terminal para llamar a la API. El siguiente comando curl de ejemplo invoca el método GET en el recurso getUsers de la fase prod de una API.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Acceder a archivos binarios en Lambda a través de una API de API Gateway

Uso de la consola para probar un método de la API de REST