驴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 () {}
);