4.2. Links (Liens)

4.2. Links (Liens)

Le tableau "links" se trouve dans les structures de données pour signifier des liens vers d'autres ressources sur Internet. La relation de ces liens est définie par le registre IANA décrit par [RFC8288].

Voici un exemple de la structure de lien:

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

Les noms/valeurs JSON de "rel", "href", "hreflang", "title", "media" et "type" correspondent aux valeurs trouvées dans la section 3 de [RFC8288]. La valeur JSON "value" est l'URI de contexte tel que décrit par [RFC8288]. Les valeurs JSON "value", "rel" et "href" DOIVENT être spécifiées. Toutes les autres valeurs JSON sont OPTIONNELLES. Une relation de lien "related" NE DOIT PAS inclure une URI "href" qui est la même que l'URI "href" de la relation de lien "self" pour réduire le risque de boucles de traitement infinies du client. Les noms de domaine internationalisés (Internationalized Domain Names, IDNs) retournés dans les URIs DEVRAIENT être retournés de manière cohérente au format de nom LDH pour permettre aux clients de traiter ces IDNs selon leurs capacités.

Ceci est un exemple du tableau "links" tel qu'il pourrait être trouvé dans une classe d'objet:

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

]