Response error list

This page provides a reference of errors, with some guidance on how to handle them.

Basics concepts

The Zeus API returns two levels of error information:

  • HTTP error codes and messages in the header.
  • A JSON object in the response body with additional details of the error.

The returned JSON object has a code field that indicates the error code and a message field that describes the error.

{
    "code":"error code",
    "message": "description"
}

400 Bad Request

  • Description: The format of the request is incorrect. This can mean that the URI is not valid, a required parameter has not been provided or it is invalid, there is a problem with the payload or headers.
  • Suggested action: Do not retry the request. Read the error message and change the request.

401 Unauthorized

  • Description: Invalid authorization header. The access token you're using is either expired or invalid or the user does not exist.
  • Suggested action: Get a new access token.

403 Forbidden

  • Description: A POST request has been made and the user does not have permissions to use the API.
  • Suggested action: Enable the use of the API for the user in ZeusServer or contact our technical service to enable these permissions.

404 Not Found

  • Description: The resource was not found. This happens when there is not resource in the URI, or it is invalid.
  • Suggested action: Do not retry the request. Read the error message and change the request.

405 Method Not Allowed

  • Description: The only methods allowed are GET and POST.
  • Suggested action: Do not retry the request. Read the error message and change the request.

500 Internal Server Error

  • Description: An internal error has occurred on the server. This happens when the struct of the request is invalid or there is an error with encrypt/decrypt/encoding/decoding/parse data.
  • Suggested action: Do not retry the request. Read the error message and change the request or contact our technical service providing the error information.

Unknow

  • Description: You receive an error code different from the previous ones.
  • Suggested action: Contact our technical service providing the error information.