Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support localized problem detail messages #124

Open
jpraet opened this issue Oct 21, 2024 · 2 comments · May be fixed by #133
Open

Support localized problem detail messages #124

jpraet opened this issue Oct 21, 2024 · 2 comments · May be fixed by #133

Comments

@jpraet
Copy link
Contributor

jpraet commented Oct 21, 2024

The problem RFC 9457 allows for localized problem title and detail.
Belgif guidelines state the problem title should be in English (why?).

The requested language can be specified in an Accept-Language HTTP request header (see https://www.belgif.be/specification/rest/api-guide/#i18n-negotiation).

The rest-problem-java library could support localized problem (and issue) detail messages.

@jpraet
Copy link
Contributor Author

jpraet commented Oct 21, 2024

@pvdbosch do you know why the Belgif guidelines require the problem title to be in English, while the RFC 9457 does allow for it to be localized?

If that restriction is kept, maybe it should be added to the "This guide applies following additional restrictions on the Problem Details structure:" section.

@pvdbosch
Copy link
Contributor

The reason was that the problem title is meant for technical support people. They don't necessarily use the same language as the end user, and it's probably more beneficial to have a single recognizable message then.

The schema provides a bit more explanation: Written in English and readable for engineers (usually not suited for non technical stakeholders and not localized).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants