Takes problem details as they are handed out by success and shows them as a
note telling of a failure, so that a screen with nothing to render says why rather than staying blank. The notice
is read out as soon as it reaches the page, the failure arriving where the reader expected what they asked for.
A failure the reader can act on is told in their own terms and left at that: an unidentified reader (401), one
denied access (403) and a resource missing (404) or withdrawn (410) are each answered by the reader themselves. Such
a fault is raised by the interface itself, and its detail is the wording the reader is told, standing under the
mark with its line breaks shown where they are written; a standing English wording for the status if omitted. The
summary and the data carried along say nothing the reader can use, and are left out.
Anything else is an unexpected failure, a technical error raised by the source: the headline states the status
and the summary the source gave it, and everything else the source supplied stands beneath, the explanation first,
then the machine-readable data, so that whoever maintains the interface finds what they need to place the failure.
Creates a fault notice.
Takes problem details as they are handed out by success and shows them as a note telling of a failure, so that a screen with nothing to render says why rather than staying blank. The notice is read out as soon as it reaches the page, the failure arriving where the reader expected what they asked for.
A failure the reader can act on is told in their own terms and left at that: an unidentified reader (401), one denied access (403) and a resource missing (404) or withdrawn (410) are each answered by the reader themselves. Such a fault is raised by the interface itself, and its
detailis the wording the reader is told, standing under the mark with its line breaks shown where they are written; a standing English wording for the status if omitted. The summary and the data carried along say nothing the reader can use, and are left out.Anything else is an unexpected failure, a technical error raised by the source: the headline states the status and the summary the source gave it, and everything else the source supplied stands beneath, the explanation first, then the machine-readable data, so that whoever maintains the interface finds what they need to place the failure.