Zum Hauptinhalt springen

4.2. Links (Links)

Das "links"-Array befindet sich in Datenstrukturen, um Links zu anderen Ressourcen im Internet zu kennzeichnen. Die Beziehung dieser Links wird durch das in [RFC8288] beschriebene IANA-Register definiert.

Das Folgende ist ein Beispiel für die Link-Struktur:

{
  "value" : "https://example.com/context_uri",
  "rel" : "self",
  "href" : "https://example.com/target_uri",
  "hreflang" : [ "en", "ch" ],
  "title" : "title",
  "media" : "screen",
  "type" : "application/json"
}

Die JSON-Namen/-Werte von "rel", "href", "hreflang", "title", "media" und "type" entsprechen den in Abschnitt 3 von [RFC8288] gefundenen Werten. Der "value"-JSON-Wert ist der Kontext-URI, wie er von [RFC8288] beschrieben wird. Die "value"-, "rel"- und "href"-JSON-Werte MÜSSEN angegeben werden. Alle anderen JSON-Werte sind OPTIONAL. Eine "related"-Link-Beziehung DARF KEINE "href"-URI enthalten, die dieselbe ist wie die "self"-Link-Beziehung "href"-URI, um das Risiko unendlicher Client-Verarbeitungsschleifen zu reduzieren. Internationalisierte Domainnamen (Internationalized Domain Names, IDNs), die in URIs zurückgegeben werden, SOLLTEN konsistent im LDH-Namensformat zurückgegeben werden, um Clients zu ermöglichen, diese IDNs entsprechend ihren Fähigkeiten zu verarbeiten.

Dies ist ein Beispiel für das "links"-Array, wie es in einer Objektklasse gefunden werden könnte:

"links" :
[
    {
      "value" : "https://example.com/ip/2001:db8::123",
      "rel" : "self",
      "href" : "https://example.com/ip/2001:db8::123",
      "type" : "application/rdap+json"
    },
    {
      "value" : "https://example.com/ip/2001:db8::123",
      "rel" : "up",
      "href" : "https://example.com/ip/2001:db8::/48",
      "type" : "application/rdap+json"
    }

]
Letztes Update am