Best way to return error messages on REST services?

 

I've been looking at examples of REST API's like Netflix http://developer.netflix.com/docs/REST_API_Reference#0_59705 and Twitter and they seem to place error messages in the statusText header response instead of the responseText. We're developing an internal RESTful api and I am arguing for sending custom statusText messages and ignoring the responseText.

For the scope of our app, we're returning error 400 when the user has tried doing something they aren't supposed to, and the only error messages that will be updated in the UI for the user will be delivered with 400. I am of the belief that the message should be sent as a modified statusText but one of the engineers (who knows a bit less about REST than me) is arguing for sending it in the responseText.

What's the best way to go?

I think you're right, the general approach is use the existing error mechanism built into HTTP.

In general, try to map your errors to existing HTTP errors, for example if they request something they don't have permission to, return a 403 error.

If they request something that doesn't exist, return a 404.

  • Alex

    • HTTP defines that you should put a descriptive error message in the response entity body, aka responseText.

    statusText is not rendered or processed by any client.

    I'd use the status text for the error message type, aka 400 Client Error, and the body for a description of the problem that can be rendered to the user, in whatever the format the client may be able to process.

    Edit: Note that since then, a new standardised format exists to communicate in a standard fashion error details back to the client, which you can find at https://tools.ietf.org/html/rfc7807 and which I would recommend.

    According to the HTTP specification (rfc2616): "HTTP status codes are extensible"

    However I don't think that creating new statuses for every different error message is the correct approach:

    I would say choose HTTP Status appropriately (HTTP Status Code Definitions) if you can't find any category which matches your requirement create a custom one (but I'm sure you will) and put error messages in the HTTP response body.

    链接地址: http://www.djcxy.com/p/45320.html

    上一篇: REST风格的Web服务：方法名称，输入参数和返回值？

    下一篇: 在REST服务上返回错误消息的最佳方法？