Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Cette section fournit des détails sur les fonctionnalités d'API Gateway dont vous avez besoin pour développer votre API Gateway APIs.
Au fur et à mesure que vous développez votre API API Gateway, vous décidez d’un certain nombre de caractéristiques de votre API. Ces caractéristiques dépendent du cas d’utilisation de votre API. Par exemple, vous pourriez vouloir autoriser uniquement certains clients à appeler votre API ou qu’elle soit disponible pour tout le monde. Vous pouvez souhaiter utiliser un appel d’API pour exécuter une fonction Lambda, créer une requête de base de données ou appeler une application.
Rubriques
- Création d’une API HTTP
- Création de routes pour les API HTTP dans API Gateway
- Contrôler et gérer l'accès au HTTP APIs dans API Gateway
- Création d’intégrations pour les API HTTP dans API Gateway
- Configurer CORS pour HTTP APIs dans API Gateway
- Transformez les demandes et les réponses d'API pour HTTP APIs dans API Gateway
- Utiliser les définitions OpenAPI pour HTTP APIs dans API Gateway
Création d’une API HTTP
Pour créer une API fonctionnelle, vous devez disposer d’au moins une route, une intégration, une étape et un déploiement.
Les exemples suivants montrent comment créer une API avec une intégration AWS Lambda ou HTTP, une route et une étape par défaut configurée pour déployer automatiquement les modifications.
Ce guide suppose que vous connaissez déjà API Gateway et Lambda. Pour obtenir un guide plus détaillé, consultez Mise en route avec API Gateway.
Rubriques
Créez une API HTTP à l'aide du AWS Management Console
-
Ouvrez la console API Gateway
. -
Sélectionnez Create API (Créer une API).
-
Sous API HTTP, choisissez Créer.
-
Choisissez Ajouter une intégration, puis choisissez une fonction AWS Lambda ou entrez un point de terminaison HTTP.
-
Dans Name (Nom), entrez le nom de votre API.
-
Choisissez Review and create.
-
Sélectionnez Create (Créer).
Maintenant, votre API est prête à être appelée. Vous pouvez tester votre API en entrant son URL d'appel dans un navigateur, ou en utilisant Curl.
curl https://
api-id
.execute-api.us-east-2
.amazonaws.com
Création d'une API HTTP à l'aide de la AWS CLI
Vous pouvez utiliser la création rapide pour créer une API avec une intégration Lambda ou HTTP, une route fourre-tout par défaut et une étape par défaut configurée pour déployer automatiquement les modifications. La commande create-api suivante utilise la création rapide pour créer une API qui s'intègre à une fonction Lambda sur le backend.
Note
Pour appeler une intégration Lambda, API Gateway doit disposer des autorisations requises. Vous pouvez utiliser une politique basée sur les ressources ou un rôle IAM pour accorder des autorisations API Gateway permettant d’appeler une fonction Lambda. Pour en savoir plus, consultez la section AWS Lambda Permissions dans le guide du AWS Lambda développeur.
aws apigatewayv2 create-api --name
my-api
--protocol-type HTTP --target arn:aws:lambda:us-east-2
:123456789012
:function:function-name
Maintenant, votre API est prête à être appelée. Vous pouvez tester votre API en entrant son URL d'appel dans un navigateur, ou en utilisant Curl.
curl https://
api-id
.execute-api.us-east-2
.amazonaws.com