Errors
If the server returned status code not equals 200 then an error occurred.
You should always check that the response is a valid JSON.
If an error occurs during the request, the server will return the response in the following format:
The response status code will be 200, not 4xx or 5xx, because it's not a REST API. If the server returned a response with code 4xx or 5xx it means that something went wrong and the server couldn't handle an error correctly, so the response may be an invalid JSON.
You have to handle both cases: if the response status code does not equals 200 and if the response contains the field "error".
Every endpoint may have it's own error codes but there are also common error codes.
Common error codes
UNKNOWN_ERROR
Unknown error occurred. Typically a server bug.
NOT_FOUND
Endpoint not found. Check request URL is correct.
RESOURCE_NOT_FOUND
Requested resource (translation, for example) not found.
METHOD_NOT_ALLOWED
The request method is not supported by a target endpoint.
INVALID_REQUEST
"Content-Type" header is not provided or it not equals "application/json".
The request is not a valid JSON.
ACCESS_TOKEN_NOT_PROVIDED
Access token is not provided.
INVALID_ACCESS_TOKEN
Access token is invalid.
TOO_MANY_REQUESTS
Too many requests. Check out limits for more information.
LANGUAGE_NOT_PROVIDED
"Language" header is not provided.
UNKNOWN_LANGUAGE
Unknown language code provided. See the list of available languages.
INVALID_PARAMETERS
Invalid parameter(s) provided.
This error means that some of the passed parameters are invalid. In response, you will get validation_errors
field with validation error messages.
Example:
INTERNAL_SERVER_ERROR
Internal server error occurred. Typically a server bug.
Last updated
Was this helpful?