Security Services Platform Documentation

Generic errors handling

1. SSP APIs error responses

The SSP services have their own specific error response body schemas, please refer to the API specifications.

However, certain generic error cases exist where standard error responses will be dispatched to the client as described below.



2. Generic error responses

2.1. Authorization token missing from the request

JSON
{
  "http-error": {
    "http-status-code": 401,
    "http-reason-phrase": "Unauthorized"
  }
}

2.2. Unknown API URL

JSON
{
  "http-error": {
    "http-status-code": 404,
    "http-reason-phrase": "Not Found"
  }
}

2.3. Unsupported HTTP verb

JSON
{
  "http-error": {
    "http-status-code": 403,
    "http-reason-phrase": "Forbidden"
  }
}

2.4. Service unavailable

HTTP status :

  • 503 (Service Unavailable)

Payload :

JSON
no healthy upstream