4.2. Links (Collegamenti)

4.2. Links (Collegamenti)

L'array "links" si trova nelle strutture dati per indicare collegamenti ad altre risorse su Internet. La relazione di questi collegamenti è definita dal registro IANA descritto da [RFC8288].

Il seguente è un esempio della struttura del collegamento:

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

I nomi/valori JSON di "rel", "href", "hreflang", "title", "media" e "type" corrispondono ai valori trovati nella Sezione 3 di [RFC8288]. Il valore JSON "value" è l'URI di contesto come descritto da [RFC8288]. I valori JSON "value", "rel" e "href" DEVONO essere specificati. Tutti gli altri valori JSON sono OPZIONALI. Una relazione di collegamento "related" NON DEVE includere un URI "href" che è lo stesso dell'URI "href" della relazione di collegamento "self" per ridurre il rischio di loop di elaborazione infiniti del client. I nomi di dominio internazionalizzati (Internationalized Domain Names, IDNs) restituiti negli URIs DOVREBBERO essere restituiti in modo coerente nel formato di nome LDH per consentire ai client di elaborare questi IDNs secondo le loro capacità.

Questo è un esempio dell'array "links" come potrebbe essere trovato in una classe di oggetto:

"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"
    }

]