Anatomía mínima de una API HTTP
Método + ruta + estado + body.
- Ruta identifica recurso.
- Método define intención (`GET`, `POST`, `PUT`, `DELETE`).
- Status code comunica resultado.
- Body JSON debe ser consistente.
JavaScript
55
Crear API básica con Node
Construye una API HTTP con Node nativo entendiendo rutas, status codes, parseo de JSON y manejo de errores.
Código del tema: http.createServer | req.method | res.writeHead
📘 Teoría
Servidor con `http.createServer`
Control total, más responsabilidad.
Endpoint GET básico
Revisar
import http from 'node:http';
const server = http.createServer((req, res) => {
if (req.method === 'GET' && req.url === '/health') {
res.writeHead(200, { 'Content-Type': 'application/json' });
res.end(JSON.stringify({ ok: true }));
return;
}
res.writeHead(404, { 'Content-Type': 'application/json' });
res.end(JSON.stringify({ error: 'Not found' }));
});
server.listen(3000);Errores que rompen APIs iniciales
La mayoría son de contrato, no de sintaxis.
- Responder `200` en errores reales.
- No establecer `Content-Type`.
- No validar body antes de procesar.
- Cambiar forma del JSON sin versión ni aviso.
Cuándo pasar a Express
Cuando necesitas routing y middlewares sin reinventar rueda.