Cianplan

Nivel 1: Fundamentos · L1.1 APIs: REST, gRPC, GraphQL, WebSockets/SSE, webhooks

Bases de REST: recursos, verbos y códigos de estado

Modelar recursos y elegir los métodos HTTP y códigos de estado correctos.

12 min · Gratis

Lo que te llevas

  • REST modela sustantivos (recursos) y reutiliza el pequeño conjunto de verbos de HTTP, en lugar de inventar un verbo por operación.
  • GET es seguro y cacheable; PUT y DELETE son idempotentes; POST no es ninguna de las dos cosas, y por eso reintentarlo es el caso difícil.
  • Los códigos de estado son la mitad legible por máquinas de tu API: cachés, proxies, clientes y dashboards actúan con base en ellos.
  • REST es un conjunto de restricciones (interfaz uniforme, peticiones sin estado, respuestas cacheables), no “JSON sobre HTTP”.

Cómo está armada la clase

  1. El problema
  2. La versión simple
  3. Los verbos, y lo que promete cada uno
  4. Los códigos de estado son una interfaz
  5. Comprueba lo que entendiste