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.
Développement d'une 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
- Utilisation des itinéraires pour les API HTTP
- Contrôle et gestion de l'accès à une API HTTP dans API Gateway
- Configuration des intégrations pour les API HTTP
- Configuration de CORS pour une API HTTP
- Transformer les demandes et les réponses d'API
- Utilisation des définitions OpenAPI pour les API HTTP
Création d'une API HTTP
Pour créer une API fonctionnelle, vous devez disposer d'au moins un itinéraire, 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é, veuillez consulter Mise en route avec API Gateway.
Rubriques
Création d'une API HTTP à l'aide d 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 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 à une fonction Lambda sur le backend.
Note
Pour appeler une intégration Lambda, API Gateway doit disposer des autorisations requises. Vous pouvez utiliser une stratégie 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 --namemy-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
