Ottieni la tua chiave API Screeb
Trova la chiave API del tuo workspace, usala per inviare dati e release a Screeb dal tuo backend e rigenerala se viene compromessa.
Questa pagina è stata tradotta automaticamente. La versione inglese fa fede.
La chiave API del workspace permette ai tuoi server di comunicare con Screeb, senza il tag né un SDK mobile. Ogni workspace ha una sola chiave.
Prima di iniziare
Sezione intitolata “Prima di iniziare”- La pagina API Screeb e il reset della chiave sono riservati ai membri con il ruolo Admin nell’organizzazione.
- Un Editor o un Admin del workspace può copiare la chiave da Release, vedi Rigenera la chiave. Un Analista non può vederla.
- La chiave è un segreto: chiunque la possieda può inviare dati al tuo workspace. Tienila sui tuoi server, mai nel codice del tuo sito o della tua app.
Copia la chiave
Sezione intitolata “Copia la chiave”- Nella barra laterale del workspace, clicca su Impostazioni, poi, sotto Dati e deployment, clicca su API Screeb.
- Sotto Chiave API del workspace, clicca su Copia.
- Consegna la chiave allo sviluppatore che configura l’integrazione, tramite un canale sicuro come il tuo password manager.

La chiave non è l’ID del workspace che si trova nel codice di installazione del tuo sito o della tua app. Quell’ID è pubblico e serve solo a identificare il workspace per il tag e gli SDK, vedi Installa Screeb sul tuo sito web o sulla tua web app.
Usa la chiave
Sezione intitolata “Usa la chiave”I tuoi sviluppatori la inviano nell’header Authorization: Bearer di ogni richiesta all’API Screeb. Con essa possono:
- Inviare i dati utente dal tuo backend: proprietà utente, eventi, gruppi, visualizzazioni di pagine e schermate. Vedi Invia e gestisci le proprietà utente e Traccia e gestisci gli eventi utente.
- Registrare le Release dalla tua pipeline di deploy, vedi Tieni traccia delle tue Release.
Endpoint, payload e limiti sono nella documentazione di riferimento dell’API Screeb.
Alcune integrazioni mostrano il proprio token nella loro pagina. Quel token è separato dalla chiave API del workspace.
Rigenera la chiave
Sezione intitolata “Rigenera la chiave”Rigenera la chiave se è stata compromessa o se una persona che la conosceva lascia il tuo team.
- Apri Release e clicca su Crea Release tramite API. La finestra mostra la stessa chiave, con un pulsante di copia per gli Editor e gli Admin del workspace.
- Clicca su Reimposta, poi su Reimposta token. La nuova chiave sostituisce subito quella vecchia. Solo gli Admin dell’organizzazione vedono Reimposta.
- Consegna la nuova chiave ai tuoi sviluppatori e aggiorna ogni server, script e pipeline che usava la vecchia.
Il reset non si può annullare. Ogni chiamata che usa ancora la vecchia chiave fallisce con un errore di autorizzazione finché non riceve la nuova, sia per i dati utente sia per le Release.
Cosa ottieni
Sezione intitolata “Cosa ottieni”Il tuo backend può inviare dati e Release a Screeb, e sai dove ruotare la chiave quando serve.
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”L’API risponde 401 Unauthorized. La chiave manca, è stata digitata male o è stata rigenerata. Copiala di nuovo da API Screeb e controlla che l’header sia Authorization: Bearer seguito dalla chiave.
I dati finiscono nel workspace sbagliato. Ogni workspace ha la propria chiave. Controlla di aver copiato la chiave del workspace che stai guardando.