Richieste e risposte

Leggi insieme stato HTTP, dati JSON tipizzati e metadati della richiesta.

Richiesta

Content-Type: application/json: Invia le scritture JSON con Content-Type: application/json.
data · meta: Le risposte riuscite contengono data e meta; le collezioni includono anche la paginazione.
error.code · error.message: Gli errori contengono error.code, error.message e, quando pertinenti, informazioni sui campi.

Obbligatorietà e possibilità di usare null sono indipendenti.
Un campo obbligatorio può contenere null se lo schema lo consente.
Mantieni booleani, interi, stringhe e null nei rispettivi tipi JSON, senza conversioni implicite.
Gli importi monetari sono stringhe decimali: non calcolare i prezzi con numeri binari in virgola mobile.

Alcune versioni di concorrenza usano interi con segno a 64 bit.
Un client JavaScript deve gestire il JSON senza perdita di precisione per valori superiori a Number.MAX_SAFE_INTEGER e inviare la rappresentazione intera originale.
Non arrotondare la versione e non convertirla in una stringa JSON.

Cache-ControlStringaFacoltativo: Politica di memorizzazione temporanea della risposta.

const: "no-store"
X-Correlation-IDStringaFacoltativo: Identificativo per tracciare questa richiesta HTTP.
WWW-AuthenticateStringaFacoltativo: Schema di autenticazione richiesto dal server.
AllowStringaFacoltativo: Metodi HTTP supportati da questa risorsa.
Retry-AfterInteroFacoltativo: Attesa minima prima di riprovare, in secondi.

minimum: 0
LocationStringaFacoltativo: URL relativo della risorsa creata.