Error management
Shlink’s REST API implements the Problem Details standard for error management.
Because of this, all error responses will have Content-Type: application/problem+json
, and the payload will have at least these properties:
type
: A unique error code identifying the error.detail
: A human-friendly description of the error.title
: A short unique error title.status
: The same value returned as the response status code.
{
"type": "https://shlink.io/api/error/tag-not-found",
"detail": "Tag with name \"foo\" could not be found",
"title": "Tag not found",
"status": 404
}
Some errors can have extra properties, depending on their nature.
{
"type": "https://shlink.io/api/error/non-unique-slug",
"detail": "Provided slug \"custom\" is already in use",
"title": "Invalid custom slug",
"status": 400,
"customSlug": "custom"
}
Error interpretation depends on the context and the endpoint. Every endpoint includes the documentation for its specific errors.
For more information, read the API specification.