You could start with naming things properly. You didn't describe errors generally in APIs, you described errors returned by REST applications. For example, your

You could start with naming things properly. You didn't describe errors generally in APIs, you described errors returned by REST applications. For example, your post is completely useless for people writing libraries.