2.1. Naming (Denominazione)

I client di queste risposte JSON DOVREBBERO ignorare i membri JSON non riconosciuti nelle risposte. I server possono inserire membri nelle risposte JSON che non sono specificati in questo documento, ma ciò non costituisce un errore nella risposta. I server che inseriscono tali membri non specificati nelle risposte JSON DOVREBBERO avere nomi di membri preceduti da un identificatore breve seguito da un underscore seguito da un nome significativo. È stato osservato che questi identificatori brevi aiutano gli implementatori di software a identificare la specifica del membro JSON, e la mancata utilizzazione di uno potrebbe indurre un implementatore a presumere che il server stia utilizzando erroneamente un nome da questa specifica. Questa concessione non si applica agli oggetti jCard [RFC7095]. Il nome JSON completo (il prefisso più l'underscore più il nome significativo) DOVREBBE aderire alle limitazioni di caratteri e nomi del registro dei prefissi descritto in [RFC7480]. Il mancato utilizzo di queste limitazioni potrebbe portare a un'adozione più lenta poiché è stato osservato che queste limitazioni aiutano alcuni modelli di programmazione client.

Considerate la seguente risposta JSON con membri JSON, tutti specificati in questo documento.

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

Figura 1

Se il Registro della Luna desidera esprimere informazioni non trovate in questa specifica, potrebbe selezionare "lunarNIC" come prefisso identificativo e inserire, ad esempio, il membro denominato "lunarNIC_beforeOneSmallStep" per indicare registrazioni avvenute prima del primo allunaggio e il membro denominato "lunarNIC_harshMistressNotes" che contiene altro testo descrittivo.

Considerate la seguente risposta JSON con nomi JSON, alcuni dei quali dovrebbero essere ignorati dai client senza conoscenza del loro significato.

{
  "handle" : "ABC123",
  "lunarNIC_beforeOneSmallStep" : "TRUE THAT!",
  "remarks" :
  [
    {
      "description" :
      [
        "She sells sea shells down by the sea shore.",
        "Originally written by Terry Sullivan."
      ]
    }
  ],
  "lunarNIC_harshMistressNotes" :
  [
    "In space,",
    "nobody can hear you scream."
  ]
}

Figura 2

L'inserimento di membri non riconosciuti ignorati dai client può essere utilizzato anche per future revisioni di questa specifica.

I client che elaborano risposte JSON devono essere preparati al fatto che i membri che rappresentano dati di registrazione specificati in questo documento possano essere assenti da una risposta. In altre parole, i server sono liberi di omettere membri JSON non richiesti/opzionali contenenti dati di registrazione in base alle proprie politiche.

Infine, tutti i nomi JSON specificati in questo documento sono sensibili alle maiuscole/minuscole. Sia i server che i client DEVONO trasmetterli e processarli utilizzando la maiuscola/minuscola dei caratteri specificata.

2.1. Naming (Denominazione)​

2.1. Naming (Denominazione)