Développement d’API HTTP dans API Gateway
Cette section fournit des détails sur les fonctionnalités d’API Gateway dont vous avez besoin pendant le développement de vos API API Gateway.
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ôle et gestion de l’accès à une API HTTP dans API Gateway
- Création d’intégrations pour les API HTTP dans API Gateway
- Configuration de CORS pour les API HTTP dans API Gateway
- Transformation des demandes et des réponses d’API HTTP dans API Gateway
- Utilisation des définitions OpenAPI pour les API HTTP 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éation d’une API HTTP à l’aide de l’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 CLI AWS
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 suivante utilise la création rapide pour créer une API qui s’intègre avec 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 Autorisations AWS Lambda dans le Guide du développeur AWS Lambda.
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