Diseñar una API REST sin sorpresas
Convenciones pequeñas para crear endpoints predecibles, errores útiles y contratos que duren.
20 de agosto de 2026 · LBE · 1 min de lecturaUna API agradable no necesita ser ingeniosa. Necesita ser coherente. Los nombres, estados HTTP y formatos de error deberían permitir que otra persona anticipe su comportamiento.
Recursos, no acciones
Modelar rutas alrededor de sustantivos mantiene el vocabulario pequeño. Los métodos HTTP ya expresan la operación principal.
Errores para personas y máquinas
Incluye un código estable, un mensaje comprensible y, cuando corresponda, el campo responsable. Evita filtrar detalles internos del servidor.
Evolución deliberada
Documenta el contrato y prueba los casos importantes. Un cambio aparentemente pequeño en un tipo o valor nulo puede romper consumidores que no controlas.
La previsibilidad es una característica: reduce preguntas, errores y tiempo de integración.
Comentarios