4.3. Notices and Remarks (Avvisi e osservazioni)

Le strutture dati "notices" e "remarks" assumono la stessa forma. La struttura notices denota informazioni sul servizio che fornisce informazioni RDAP e/o informazioni sull'intera risposta, mentre la struttura remarks denota informazioni sulla classe di oggetto che la contiene (vedere la Sezione 5 riguardo alle classi di oggetti).

Entrambe sono array di oggetti. Ogni oggetto contiene una stringa "title" che rappresenta il titolo dell'oggetto, una stringa "type" che denota un tipo registrato di osservazione o avviso (vedere la Sezione 10.2.1), un array di stringhe denominato "description" allo scopo di trasmettere qualsiasi testo descrittivo, e un array "links" come descritto nella Sezione 4.2. L'array "description" DEVE essere incluso. Tutti gli altri valori JSON sono OPZIONALI.

Un esempio della struttura dati notices:

"notices" :
[
  {
    "title" : "Terms of Use",
    "description" :
    [
      "Service subject to The Registry of the Moon's TOS.",
      "Copyright (c) 2020 LunarNIC"
    ],
    "links" :
    [
      {
        "value" : "https://example.net/entity/XXXX",
        "rel" : "alternate",
        "type" : "text/html",
        "href" : "https://www.example.com/terms_of_use.html"
      }
    ]
  }
]

È compito dei client determinare le interruzioni di riga, la spaziatura e i problemi di visualizzazione per le frasi all'interno delle stringhe di caratteri dell'array "description". Ogni stringa nell'array "description" contiene una singola divisione completa di testo leggibile dall'uomo che indica ai client dove ci sono interruzioni semantiche.

Un esempio della struttura dati remarks:

"remarks" :
[
  {
    "description" :
    [
      "She sells sea shells down by the sea shore.",
      "Originally written by Terry Sullivan."
    ]
  }
]

Si noti che gli oggetti nell'array "remarks" possono anche avere un array "links".

Mentre i campi "title" e "description" sono destinati principalmente al consumo umano, la stringa "type" contiene un valore ben noto da registrare con IANA (vedere la Sezione 10.2.1) per uso programmatico.

Un esempio della struttura dati remarks:

"remarks" :
[
  {
    "type" : "object truncated due to authorization",
    "description" :
    [
      "Some registration data may not have been given.",
      "Use proper authorization credentials to see all of it."
    ]
  }
]

Mentre l'array "remarks" apparirà in molte classi di oggetti in una risposta, l'array "notices" appare solo nell'oggetto più alto di una risposta.

4.3. Notices and Remarks (Avvisi e osservazioni)​

4.3. Notices and Remarks (Avvisi e osservazioni)