Modelo de madurez de Richardson

Sesión 3: 2h29m

Si queremos saber en que nivel se encuentran nuestras APIs usamos el modelo de madurez de Richardson.

Nivel 0 (Swamp of POX)

• El protocolo HTTP se utiliza para la interacción remota.
• El resto del protocolo no se usa como debería ser.
• Implementaciones de estilo RPC (SOAP, a menudo vistas cuando se usa WCF).

POST (informacion)

http://host/myapi

POST (para crear un autor)

http://localhost/authors

Nivel 1 (Recursos)

• Cada recurso se asigna a un URI
• Los métodos HTTP no se usan como deberían ser
• Resultados en complejidad reducida

POST

http://localhost/api/authors

POST

http://localhost/api/authors/{id}

Nivel 2 (Verbos)

• Se utilizan correctamente los verbos HTTP
• Se utilizan correctamente los códigos de estado
• Remueve las variaciones innecesarias
• Mínimanete deberíamos llegar a este nivel

GET

http://host/api/authors

200 OK (authors)

POST (representación de author)

http://localhost/api/authors

201 Created (author)

Nivel 3 (Hypermedia)

• La API tiene soporte de Hypermedia as the Engine of Application State (HATEOAS)
• Autodocumentación

GET

http://host/api/authors

200 Ok (authors + links que controlan el estado de la aplicación)