Ressources et URL

Fait partie de la section API REST du Journey Node.js de Coddy. Leçon 1 sur 18.

Les autres programmeurs appellent votre API depuis leur code : ses adresses doivent donc être faciles à deviner. La plupart des API Web suivent un style appelé REST : chaque adresse désigne une chose, une ressource, et la méthode HTTP indique quoi en faire.

GET    /api/invoices      the list of invoices
GET    /api/invoices/7    invoice 7
POST   /api/invoices      add an invoice
DELETE /api/invoices/7    remove invoice 7

Le chemin contient des noms, jamais des verbes. Avec /api/getInvoices et /api/deleteInvoice?id=7, un client doit apprendre un nouveau mot pour chaque action. Un routeur monté avec app.use('/api/invoices', invoices) répond aux deux adresses : sa route '/' renvoie la liste et sa route '/:id' renvoie une seule facture. Un identifiant qui ne correspond à rien renvoie une erreur JSON 404, que le client lit comme n’importe quelle autre réponse.

Défi

Facile

Montez le routeur dans server.js à /api/tasks.
GET /api/tasks renvoie le tableau de store.js.
GET /api/tasks/:id renvoie une tâche, ou une erreur 404 avec { "error": "Task not found" }.

Appuyez sur Run et envoyez GET /api/tasks, GET /api/tasks/2 et GET /api/tasks/99.

Essayez vous-même

import { Router } from 'express';
import { tasks } from '../store.js';

const router = Router();

// Ajoutez une route pour la liste entière et une route pour une seule tâche

export default router;