Errors

An error shows first in its HTTP status: 400 for an incomplete request, 401 for a refused key or token, 404 when something isn't found, 500 when something broke on our side. The body takes one of these two forms.

Refused key or token

When the key, the login or the token is refused, the request stops before the endpoint. The message starts with the error code:

HTTP/1.1 401 Unauthorized

{"error": "102 - Invalid API key."}

Endpoint errors

Other errors use the usual response shape: the message is in data, without its code. Rely on the HTTP status, and show the message as is if needed.

HTTP/1.1 404 Not Found

{"data": ["Article not found."], "meta": {}}

Codes and messages