AWS Gateway est un outil puissant pour créer des API qui évoluent pour répondre aux exigences des applications Web et mobiles modernes. Avec AWS Gateway, vous pouvez créer des API RESTful qui exposent vos données et votre logique métier aux développeurs, qui peuvent ensuite créer des applications riches et interactives qui utilisent votre API.
L’API REST est une norme de l’industrie pour la création d’applications Web évolutives et distribuées. Avec AWS Gateway, vous pouvez facilement créer une API REST qui prend en charge les méthodes GET et POST, ainsi que les paramètres de requête complexes. Vous pouvez également ajouter la prise en charge d’autres méthodes HTTP, telles que PUT, DELETE et HEAD.
Grâce à AWS Gateway, vous pouvez créer rapidement des API sécurisées et robustes. Vous pouvez également l’utiliser pour déployer votre code dans un environnement de production avec un minimum d’effort. De plus, AWS Gateway permet une intégration transparente avec d’autres services AWS, tels que S3 et DynamoDB, vous permettant d’ajouter facilement des fonctionnalités complexes à vos API.
Conditions préalables
Avant de créer une API RESTful avec AWS Gateway, vous devez disposer des éléments suivants :
- Créez un compte AWS si vous n’en avez pas déjà un.
- Connectez-vous à AWS Management Console et accédez au service Amazon API Gateway.
-
Cliquez sur « Créer une API » et sélectionnez « API REST ».
- Cliquez sur « Actions », définissez la ressource et cliquez sur « Créer une ressource ».
- Sélectionnez la ressource nouvellement créée et cliquez sur « Créer une méthode ».
- Choisissez le verbe HTTP (par exemple, GET, POST, PUT, etc.) et cliquez sur la coche pour créer la méthode.
- Dans la section « Type d’intégration », sélectionnez « Fonction Lambda » et entrez le nom de la fonction Lambda que vous souhaitez utiliser pour gérer les demandes d’API. Cliquez sur « Enregistrer » pour créer l’API.
- Sélectionnez Nœud dans la liste déroulante Runtime.
Exemple de code
let user = {
firstName: "John",
lastName: "Smith",
location: "Bay Area"
}
export const handler = async(event) => {
// TODO implement
console.log(">>>> Inside Lambda Function....");
if(event.httpMethod === "GET")
{
getUserRecord(event);
}
if(event.httpMethod === "POST")
{
createUserRecord(event)
}
const response = {
statusCode: 200,
body: JSON.stringify({
user_details: user
})
};
return response;
};
function getUserRecord (event) {
const response = {
statuscode: 200,
body: JSON.stringify({
user_details: user
})
};
return response;
}
function createUserRecord(event) {
const body = JSON.parse(event.body);
const response = {
statusCode: 200,
body:JSON.stringify({
message: "successfully created",
details: body
})
};
return response;
}
Le code crée d’abord un objet appelé user qui contient certaines propriétés telles que firstName, lastName et location.
Ensuite, la fonction de gestionnaire vérifie le HTTPMethod propriété de l’objet événement ; si c’est « GET », il appelle le getUserRecord fonction, et si c’est « POST », il appelle la fonction createUserRecord.
Les fonctions getUserRecord et createUserRecord prennent l’objet événement comme entrée et renvoient l’objet réponse.
Dans la fonction getUserRecord, il crée un objet de réponse avec un statusCode de 200 et un corps qui contient un objet JSON avec user_details propriété qui est l’objet utilisateur créé au début.
Dans la fonction createUserRecord, il analyse d’abord le event.body qui est une chaîne, dans un objet JSON, puis crée un objet de réponse avec un statusCode de 200 et un corps qui contient un objet JSON avec des propriétés de message et de détails.
Déployez l’API en cliquant sur « Actions » et en sélectionnant « Déployer l’API ».
Sélectionnez une étape de déploiement (par exemple, « prod » ou « test ») et cliquez sur « Déployer ». Utilisez le point de terminaison d’API généré pour envoyer des demandes à votre API.
Exécuter et tester le code dans Postman
Maintenant, notre API est opérationnelle. Vous pouvez envoyer une requête HTTP de test via Postman. En envoyant une requête à votre URL d’invocation, vous devriez voir un code d’état 200 OK. Pour ce test, aucun corps de requête n’est nécessaire pour la requête entrante.
Emballer
Avec cela, nous avons créé une API RESTful simple à l’aide d’AWS Lambda. Ce code peut ensuite être développé selon les besoins pour créer des API pour vos applications.