Error handling in the REST API is fully based on HTTP error code= s. As a web developer, you are probably familiar with the most common ones:= 401 Unauthorized, 404 Not Found or 500 Internal Server Error. Th= e REST API uses those, along with a few more, to allow proper error handlin= g.
The complete list of error codes used and the conditions in which they a= pply are specified in the reference documentation.
A few error codes apply to most resources (if they are app= licable)
The server encountered an unexpected condition, usually an excepti= on, which prevented it from fulfilling the request: database down, permissi= ons or configuration error.
Returned when the requested method has not yet been implemented. A= s of eZ Publish 5.0, most of User, User group, Content, Location and Conten= t Type have been implemented. Some of their methods, as well as other featu= res, may return a 501.
Returned when the request failed because the request object was no= t found. You should be familiar with this one.
Returned when the requested REST API resource doesn't support the = HTTP verb that was used.
Returned when an accept header sent with the requested isn't suppo= rted.
It is up to you, in your client implementation, to handle those co= des by checking if an error code (4xx or 5xx) was returned instead of the e= xpected 2xx or 3xx.