Zum Hauptinhalt springen

5. The Link Header Field (Das Link-Header-Feld)

Das Link-Header-Feld bietet eine Möglichkeit zur Serialisierung von Links in HTTP-Headern.

Überblick

Semantische Äquivalenz:

  • Äquivalent zum HTML-Element <LINK>
  • Äquivalent zum Atom-Element atom:link auf Feed-Ebene

ABNF-Syntax

Link           = "Link" ":" #link-value
link-value = "<" URI-Reference ">" *( ";" link-param )
link-param = ( ( "rel" "=" relation-types )
| ( "anchor" "=" <"> URI-Reference <"> )
| ( "hreflang" "=" Language-Tag )
| ( "media" "=" ( MediaDesc | ( <"> MediaDesc <"> ) ) )
| ( "title" "=" quoted-string )
| ( "title*" "=" ext-value )
| ( "type" "=" ( media-type | quoted-mt ) ) )

Komponenten

5.1. Ziel-IRI

  • Übermittelt als URI-Reference in spitzen Klammern <>
  • Relative URIs werden gemäß RFC 3986 aufgelöst

5.2. Kontext-IRI

  • Standard: IRI der angeforderten Ressource
  • Überschreibung: Verwenden Sie den Parameter anchor

5.3. Beziehungstyp

  • Spezifiziert im Parameter rel
  • Darf nicht (MUST NOT) mehr als einmal pro link-value erscheinen
  • Parameter rev: VERALTET

5.4. Zielattribute

ParameterBeschreibung
hreflangSprachhinweis für Zielressource
mediaBeabsichtigtes Medium für Style-Informationen
titleMenschenlesbares Label
title*Kodiertes Label (RFC 5987)
typeMedientyp-Hinweis

5.5. Beispiele

Einfache Navigation:

Link: `http://example.com/TheBook/chapter2`; rel="previous";
title="vorheriges Kapitel"

Mehrere Links:

Link: </TheBook/chapter2>; rel="previous"; title*=UTF-8'de'letztes%20Kapitel,
</TheBook/chapter4>; rel="next"; title*=UTF-8'de'n%C3%A4chstes%20Kapitel