Errors
The Ferienpass API uses standard HTTP status codes and returns a JSON error body whenever a request cannot be fulfilled.
Status codes
- Name
200 OK- Description
The request was successful.
- Name
401 Unauthorized- Description
Authentication is required or the provided token is invalid or expired.
- Name
403 Forbidden- Description
The authenticated user does not have permission to access this resource.
- Name
404 Not Found- Description
The requested resource does not exist.
- Name
429 Too Many Requests- Description
Rate limit exceeded. See the authentication page for details.
- Name
500 Internal Server Error- Description
An unexpected server-side error occurred.
Error response format
When a request fails, the API returns a JSON body following the RFC 7807 Problem Details format:
- Name
type- Type
- string
- Description
A URI reference identifying the error type.
- Name
title- Type
- string
- Description
A short, human-readable summary of the error.
- Name
detail- Type
- string
- Description
A more detailed explanation of the specific error that occurred.
- Name
status- Type
- integer
- Description
The HTTP status code.
401 Unauthorized
{
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "An error occurred",
"detail": "Invalid credentials.",
"status": 401
}
404 Not Found
{
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "An error occurred",
"detail": "Not Found",
"status": 404
}
Token expired
{
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "An error occurred",
"detail": "Token expired",
"status": 401
}
429 Too Many Requests
{
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "An error occurred",
"detail": "Rate limit exceeded.",
"status": 429
}