RESTful Best Practices: ¿Soy REST o RESTful?

Esta presentación resume perfectamente si mis Servicio REST es verdaderamente REStful

(este te va a gustar Luis 😉 )

• En RESTful todo es un Recurso, entendiendo como recurso lo que el sistema expone al mundo exterior:

• Fundamental es mantener un interfaz uniforme usando los verbos HTTP: GET, POST, PUT, DELETE.

Algunos errores típicos al trabajar con RESTful:

• Mapear tu ActiveRecord con tu Recurso
• Pensar que para cada recurso hay que implementar todas las acciones (algunos recursos pueden ser de solo lectura por ejemplo)
• Añadir métodos a medida si los estándares no encajan (típico :D)

Y para acabar veamos algunos ejemplos del API de LinkedIn que nos aclaran mejor todo esto:

• Para obtener el perfil de un miembro:

• Para obtener sólo ciertos campos del perfil (interesante, verdad?):

• Para actualizar el perfil:

• Para modificar el nombre de un usuario:

• Para añadir un amigo:

• Eliminar un amigo:

• Eliminar una compañía:

• Eliminar 2 compañías: