Error handling

Spotnana uses the following standard HTTP response codes to indicate the status of an API request:

• 2xx Successful – The request was successfully received, understood, and accepted.
• 4xx Client error – The request contains bad syntax or invalid parameter.
• 5xx Server error – The server failed to fulfil a request.

Error Details

Apart from the standard HTTP error codes, the error response contains a errorMessages > errorCode field that gives you additional context about the error.

Here are some sample API error responses:

Sample 1: HTTP/1.1 400 Bad Request

{
    "debugIdentifier": "https://debug.services.spotnana.com/file-search-results/5404d15aa99f5e2d4?q=debugid",
    "errorMessages": [
        {
            "errorCode": "INVALID_EMAIL_DOMAIN"
        }
    ]
}

Sample 2: HTTP/1.1 401 Unauthenticated

{
  "debugIdentifier": "https://debug.services.spotnana.com/file-search-results/null_a1fc321663723ce3?q=debugid",
  "errorMessages": [
    {
      "errorCode": "USER_NOT_AUTHENTICATED"
    }
  ]
}