Développement d'API HTTP dans API Gateway - APIPasserelle Amazon

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'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.

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 Commencez avec API Gateway.

Créez une API HTTP à l'aide du AWS Management Console

  1. Ouvrez la console API Gateway.

  2. Sélectionnez Create API (Créer une API).

  3. Sous API HTTP, choisissez Créer.

  4. Choisissez Ajouter une intégration, puis choisissez une fonction AWS Lambda ou entrez un point de terminaison HTTP.

  5. Dans Name (Nom), entrez le nom de votre API.

  6. Choisissez Review and create.

  7. Choisissez 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 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 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