Recursos, no acciones
Una API REST modela recursos: cosas que tienen identidad (usuarios, pedidos, productos). Las rutas se nombran con sustantivos en plural, y es el método HTTP —no la URL— el que indica la acción:
| Acción | Método + ruta |
|---|---|
| Listar | GET /usuarios |
| Ver uno | GET /usuarios/:id |
| Crear | POST /usuarios |
| Reemplazar | PUT /usuarios/:id |
| Actualizar parcial | PATCH /usuarios/:id |
| Borrar | DELETE /usuarios/:id |
Evita verbos en la ruta (/crearUsuario, /borrarUsuario): el verbo ya está
en el método. Para recursos anidados, refleja la jerarquía:
GET /usuarios/:id/pedidos // los pedidos de un usuario
GET /usuarios/:id/pedidos/:pid // un pedido concreto de ese usuario
Códigos de estado apropiados
El código de estado comunica el resultado de la operación:
- 200 OK — petición correcta con cuerpo (listar, ver, actualizar).
- 201 Created — se ha creado un recurso (respuesta a un
POST). - 204 No Content — éxito sin cuerpo (típico de un
DELETE). - 400 Bad Request — datos de entrada inválidos o mal formados.
- 404 Not Found — el recurso pedido no existe.
res.status(201).json(nuevoUsuario); // creado
res.status(204).send(); // borrado, sin cuerpo
res.status(404).json({ error: "No encontrado" });
Usar el estado correcto no es cosmético: los clientes (apps, caches, otros servicios) toman decisiones según él.