Authentication unavailable

Status #

503

Meaning #

The API may respond with ‘Authentication unavailable’ if you’ve executed a request against any route of the API and authentication in front temporarily can’t be processed.

Semantically the response status code is equivalent to the HyperText Transfer Protocol (HTTP) 503 Service Unavailable response status code. It indicates that the server isn’t able to perform your request at the moment as cause of a server-side issue.

The 503 error is an error which is solely a server-side problem. With perspective on the authentication involved in the response of 503 status in this special case it isn’t the client’s fault that authentication in front of the request failed. This is the reason why this type of error is categorized within the scope of client-side (5xx) responses.

It’s important to point out that when you’ll get this response, you can rely on us working on fixing the issue as soon as possible.

Request #

GET https://api.gridscale.io/hybrid-core/v1/sites

Response #

Header:

HTTP/1.1 503 Service Unavailable
Content-Type: application/json; charset=utf-8
...

Body:

{
  "errors": [
    {
      "type": "https://my.gridscale.io/docs/apis/problems/hybrid-core/v1/authentication-unavailable",
      "title": "Authentication temporarily unavailable",
      "status": 503,
      "detail": "Authentication is not available right now. Our Team has already been notified and is working on solving this issue.",
      "DocURL": "https://my.gridscale.io/docs/apis/hybrid-core/v1/introduction/#auth",
    }
  ]
}