Accesso a livello di campo
Un campo può indicare quali tipi di chiamante possono leggerlo e quali scriverlo. Una nota interna può restare riservata al tuo team, e un valore impostato da un'operazione può restare fuori dal browser dell'utente.
Liste di lettura e scrittura su un campo
Un campo accetta un oggetto access facoltativo con una lista di lettura e una di scrittura. Una lista di scrittura con voci è una allow-list, e la piattaforma rifiuta qualsiasi altro chiamante su ogni percorso di scrittura. La lista di lettura stabilisce a quali chiamanti l'API client espone il campo. Un campo senza oggetto access è scrivibile da qualsiasi chiamante autenticato.
Cinque tipi di chiamante
Ogni richiesta è di uno di cinque tipi, deciso dalla credenziale che porta. Un visitatore che non ha fatto il login è public. Un utente autenticato che scrive con il proprio token, sulla tua chiave pubblica, è self. Una operazione che agisce con il token emesso per la sua esecuzione è scoped, anche quando quel token porta l'utente che l'ha attivata. Una chiave segreta è service. Una persona del tuo team, nella console o nella CLI, è admin.
Un campo che solo un'operazione può toccare
Un utente che esegue un'operazione resta quell'utente per proprietà, regole di riga, attore dell'audit e quote. Ciò che l'operazione legge e scrive conta come scoped e mai come self. Quindi un campo che elenca scoped e lascia fuori self viene letto e impostato dall'operazione, mentre il browser dell'utente non può fare né l'una né l'altra cosa.
Come viene valutata una lettura
L'API dei dati valuta le letture con gli stessi cinque tipi. Un'operazione legge come scoped, e la richiesta di un utente autenticato come self. Un visitatore e una chiave segreta leggono entrambi come public, e un membro del team in anteprima nella console legge ogni campo. Una risposta in cache calcolata per un tipo di chiamante non viene mai servita a un altro.
Leggi il dettaglio
Il riferimento dei modelli mostra l'oggetto access su un campo, i cinque tipi di chiamante e un esempio completo per un'operazione.