API RESTFul

Une API est toujours nécessaire pour créer des applications mobiles, des applications à page unique, utiliser des appels AJAX et fournir des données aux clients. Un style architectural populaire de la façon de structurer et de nommer ces API et les points de terminaison est appelé REST (Representational Transfer State). Le protocole HTTP 1.1 a été conçu en tenant compte des principes REST. REST a été introduit par Roy Fielding en 2000 dans son article Fielding Dissertations.

Les URI et les méthodes RESTful nous fournissent presque toutes les informations dont nous avons besoin pour traiter une demande. Le tableau ci-dessous résume la manière dont les différents verbes doivent être utilisés et dont les URI doivent être nommés. Nous allons créer une API de films à la fin ; voyons maintenant comment elle sera structurée.

Créons maintenant cette API dans Express. Nous utiliserons JSON comme format de données de transport car il est facile à utiliser en JavaScript et présente d'autres avantages. Remplacez votre fichier index.js par le fichier movies.js comme dans le programme suivant.

index.js

var express = require('express');
var bodyParser = require('body-parser');
var multer = require('multer');
var upload = multer();

var app = express();

app.use(cookieParser());
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
app.use(upload.array());

//Require the Router we defined in movies.js
var movies = require('./movies.js');

//Use the Router on the sub route /movies
app.use('/movies', movies);

app.listen(3000);

Maintenant que nous avons mis en place notre application, concentrons-nous sur la création de l'API.

Commencez par configurer le fichier movies.js. Nous n'utilisons pas de base de données pour stocker les films, mais nous les stockons en mémoire ; ainsi, chaque fois que le serveur redémarre, les films que nous avons ajoutés disparaissent. Ceci peut facilement être imité en utilisant une base de données ou un fichier (en utilisant le module fs de node).

Une fois que vous avez importé Express, créez un routeur et exportez-le à l'aide de module.exports -.

var express = require('express');
var router = express.Router();
var movies = [
    {id: 101, name: "Fight Club", year: 1999, rating: 8.1},
    {id: 102, name: "Inception", year: 2010, rating: 8.7},
    {id: 103, name: "The Dark Knight", year: 2008, rating: 9},
    {id: 104, name: "12 Angry Men", year: 1957, rating: 8.9}
];

//Routes will go here
module.exports = router;

GET routes

Définissons la route GET pour obtenir tous les films -.

router.get('/', function(req, res){
    res.json(movies);
});

Pour vérifier si tout fonctionne bien, exécutez votre application, puis ouvrez votre terminal et entrez -

curl -i -H "Accept: application/json" -H "Content-Type: application/json" -X GET 
localhost:3000/movies

La réponse suivante s'affiche -

[{"id":101,"name":"Fight Club","year":1999,"rating":8.1},
{"id":102,"name":"Inception","year":2010,"rating":8.7},
{"id":103,"name":"The Dark Knight","year":2008,"rating":9},
{"id":104,"name":"12 Angry Men","year":1957,"rating":8.9}]

Nous avons une route pour obtenir tous les films. Créons maintenant une route pour obtenir un film spécifique par son identifiant.

router.get('/:id([0-9]{3,})', function(req, res){
    var currMovie = movies.filter(function(movie){
        if(movie.id == req.params.id){
            return true;
        }
    });
    if(currMovie.length == 1){
        res.json(currMovie[0])
    } else {
        res.status(404);//Set status to 404 as movie was not found
        res.json({message: "Not Found"});
    }
});

Cela nous permettra d'obtenir les films en fonction de l'identifiant que nous avons fourni. Pour vérifier la sortie, utilisez la commande suivante dans votre terminal -

curl -i -H "Accept: application/json" -H "Content-Type: application/json" -X GET 
localhost:3000/movies/101

Vous obtiendrez la réponse suivante -

{"id":101,"name":"Fight Club","year":1999,"rating":8.1}

Si vous visitez une route non valide, elle produira une erreur cannot GET, tandis que si vous visitez une route valide avec un id qui n'existe pas, elle produira une erreur 404.

Nous en avons terminé avec les routes GET, passons maintenant à la route POST.

POST route