Der Link-Header und Link-Relationstypen

Worum es geht

RFC 8288 modelliert einen Link als Kontext, Relationstyp, Ziel und optionale Zielattribute. In einem Header wird er so serialisiert:

Link: </orders?cursor=abc>; rel="next",
      </openapi.json>; rel="service-desc"; type="application/json",
      </docs/orders>; rel="service-doc"

Regeln aus dem RFC: Mehrere Links werden durch Kommas getrennt; rel ist erforderlich, und nur sein erstes Vorkommen zählt, aber ein rel-Wert kann mehrere durch Leerzeichen getrennte Relationstypen auflisten; rev ist veraltet. Registrierte Relationsnamen sind Kleinbuchstaben-Tokens, die gross-/kleinschreibungsunabhängig verglichen werden; alles Unregistrierte muss eine absolute URI sein und wird in Anführungszeichen gesetzt, wenn es ; oder , enthält. Relative Ziele werden gegen die Request-URI aufgelöst, nie gegen ein <base> im Body. Der Kontext ist standardmässig die angeforderte Ressource; anchor verschiebt ihn auf ein Fragment oder eine andere URI. hreflang, media, title, title* und type sind Hinweise zum Ziel. Die IANA-Registry listet die registrierten Namen, darunter alternate, canonical, describedby, next, prev, first, last, self, license, service-desc, service-doc, deprecation, sunset, preload und preconnect. RFC 8297 definiert die 103-Early-Hints-Antwort, deren Zweck es ist, Link-Header vor der endgültigen Antwort zu senden, damit ein Client mit dem Abruf beginnen kann.

Warum es wichtig ist

JSON, PDFs, Bilder und Markdown haben kein <link>-Element. Der Header gibt ihnen kanonische, alternative und Paginierungslinks, die Agenten, Crawler und generische Clients lesen können, ohne den Body zu parsen, und er hält die Paginierungslogik unabhängig vom Payload-Format.

So wird es angewendet

• Mit rel="next" paginieren (und prev, first, last, wenn günstig zu haben); next auf der letzten Seite weglassen, damit ein clientseitiger Durchlauf terminiert.
• Maschinenlesbare Alternativen mit rel="alternate"; type="text/markdown" versehen, die API-Beschreibung mit rel="service-desc", menschliche Dokumentation mit rel="service-doc".
• rel="canonical" auf Nicht-HTML-Repräsentationen verwenden sowie rel="deprecation" und rel="sunset" neben diesen Headern.
• Hinweise für frühes Abrufen als Link: </app.css>; rel="preload"; as="style" senden; as ist ein von HTML definierter Parameter, der als Erweiterung mitgeführt wird.
• Mit einer Bibliothek parsen: Werte können über mehrere Link-Felder verteilt sein, die einem einzigen, mit Kommas verbundenen Feld entsprechen.

Stolpersteine

Quotierung: Eine Erweiterungs-URI mit Semikolon bricht Parser, wenn sie nicht in Anführungszeichen steht. Ein Link auf einer Fehlerantwort wie einem 404 hat einen anonymen Kontext. Viele Links blähen Header über Proxy-Grenzen hinaus auf; den Header für Navigation reservieren und grosse Linkmengen in den Body legen.