NAME

Whelk::Exception - Exceptions for your API

SYNOPSIS

        use Whelk::Exception;

        # will set the status and log the body as error. A stock error message will
        # be used in the response.
        Whelk::Exception->throw(400, body => 'weird request got rejected because of reasons');

        # no log will be created, but the hint will be returned in the API response
        Whelk::Exception->throw(403, hint => 'Access denied, not authorized');

        # fatal API error, will not return an API error page but rather regular
        # text / html error page
        Kelp::Exception->throw(500, body => 'Something went very, very wrong');

DESCRIPTION

Whelk::Exception is a tiny subclass of Kelp::Exception. It introduces a "hint" attribute, which can be set to let the user know more about the error. Much like Kelp exceptions, only 4XX and 5XX statuses are allowed.

Whelk will treat Whelk::Exception differently than Kelp::Exception. Whelk exceptions will be treated as planned API events and returned in API format. Kelp exceptions will be thrown again, letting the Kelp application handle them, which will result in plaintext or html error pages.

ATTRIBUTES

hint

This is a hint for the API user. It must be a string and will be put into the error response as-is. It will not be logged.