Tratamiento de Errores en APIS RESTful

Existen diversas aproximaciones al tratamiento de Errores en REStful.

Veamos varios ejemplos:

Facebook por ejemplo siempre devuelve un 200 (OK),

Twilio alinea los errores con los códigos de estado HTTP y además devuelve un código de error propio.

SimpleGeo también devuelve código estándar pero sin valor adicional.

Siguiendo las recomendaciones de Apigee

las recomendaciones a la hora de modelar errores en nuestro API Web serían:

Usar códigos de estado HTTP

Usar códigos de estado HTTP e intentar mapearlos con códigos relevantes de la aplicación.

Existen 70 códigos HTTP que nadie conoce completamente, por lo que se usará un subconjunto de estos.

Códigos de estado HTTP a usar

Existen 3 códigos básicos:

• Todo OK
• Error de aplicación à error cliente
• Error del API à error servidor

Que mapearemos así:

• Todo OK à 200 (OK)
• Error de aplicación à 400 (Bad Request)
• Error del API à 500 (Internal Server Error)

Adicionalmente podemos usar:

• 201 – Created
• 304 – Not Modified
• 404 – Not Found
• 401 – Unauthorized
• 403 – Forbidden

Devolver mensajes detallados en el payload