Add the error code returned in the headers as well as an example of the
JSON informative message returned in the body.

Signed-off-by: Loic Dachary <loic@dachary.org>