Skip to main content

Error Handling

In case of error, the Sandbox Portal replies with a relevant HTTP status code. The list of possible status codes is, but not limited to:

  • 400 Bad Request

  • 401 Unauthorized

  • 402 Malformed Request

  • 403 Forbidden

  • 404 Not Found

  • 405 Method Not Allowed

  • 429 Too Many Requests

  • 500 Internal Server Error

In addition to the HTTP status code, the body of the response contains a JSON describing the error.

The JSON has the following fields:

  • code - an Integer representing the HTTP status code

  • message - a String with the description of the error

  • errors - an Array of Strings which provide additional information about the error. This field is optional.

Example of a response when trying to submit a URL with invalid options:

    "code": 400,
    "message": "Failed validating request",
    "errors": [
        "Invalid URL provided",
        "Invalid detonation object",
        "Invalid detonation options object"