EN

REST en la práctica: recursos, verbos y convenciones

Qué significa diseñar una API RESTful, cómo nombrar rutas y cuándo usar cada método HTTP en proyectos reales.

REST no es un framework: es un estilo arquitectónico. Modela tu dominio como recursos identificables por URL y manipúlalos con los verbos HTTP de forma predecible.

Principios clave

  • Recursos nombrados: /orders, /users/12/profile.
  • Verbos con significado: GET lee, POST crea, PATCH actualiza parcialmente.
  • Representaciones intercambiables: JSON, XML, etc.
  • Stateless: el servidor no guarda sesión de UI entre peticiones.
            GET    /api/v1/products
POST   /api/v1/products
GET    /api/v1/products/88
PATCH  /api/v1/products/88
DELETE /api/v1/products/88
          

Versiona tus APIs (/v1/), pagina colecciones grandes y devuelve códigos HTTP coherentes. Tu equipo futuro —y tus integradores— te lo agradecerán.