REST Apis con Express.js : Como crear endpoints

¿Qué es una REST API?

Del inglés Representational State Transfer (REST) que suena algo bastante complejo en realidad es bastante sencillo. REST es una forma de estandarizar la forma en la que usamos HTTP Requests.

Cuando trabajábamos en el ejemplo al momento de realizar las peticiones, dichas peticiones se podían realizar mediante diferentes métodos (GET, POST, UPDATE, DELETE, PUT).

Estandarizando las peticiones podemos entender mejor que es lo que estamos mandando solicitar y la manera en que lo estamos haciendo.

Ejemplos con colecciones

// retrae una colección de usuarios
app.get("/api/v1/usuarios", function () {});

// crea un nuevo usuario
app.post("/api/v1/usuarios", function () {});

// actualiza una colección de usuarios [id1,id2,id3]
app.post("/api/v1/usuarios", function () {});

// actualiza una colección de usuarios [id1,id2,id3]
app.post("/api/v1/usuarios", function () {});

// borra una colección de usuarios [id1,id2,id3]
app.delete("/api/v1/usuarios", function () {});

// muestra el contenido de un registro
app.get("/api/v1/usuarios/:id", function () {});

// actualiza un registro
app.put("/api/v1/usuarios/:id", function () {});

// borra un registro
app.delete("/api/v1/usuarios/:id", function () {});

Podemos incluso hacer combinaciones de modelos para producir rutas mas detalladas… supongamos que un articulo tiene comentarios.

// mostrar la colección de comentarios de un articulo
app.get("/api/v1/articulos/:articulo/comentarios", function () {});

// crear un comentario para un articulo
app.post("/api/v1/articulos/:articulo/comentarios", function () {});

// borra un comentario de un articulo
app.delete(
    "/api/v1/articulos/:articulo/comentarios/:comentario/delete",
    function () {}
);