NAME

WWW::Keycloak::Error::API - Raised when Keycloak answers with an HTTP error

VERSION

version 0.001

DESCRIPTION

Keycloak reports errors in three shapes, and all of them end up in "api_message": {"errorMessage": "..."} from most of the Admin API, {"error": "..."} from some of it, and the OAuth form {"error": "...", "error_description": "..."} from the token endpoint, where "oauth_error" also carries the bare code.

http_status

The HTTP status code as a number, for example 409.

api_message

What Keycloak said, if it said anything.

oauth_error

The OAuth error code (invalid_grant, authorization_pending, ...) when the error came from an OAuth endpoint.

is_not_found

is_conflict

is_unauthorized

True for status 404, 409 and 401.

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-keycloak/issues.

IRC

Join #kubernetes on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.