Salta ai contenuti
Screeb Help CenterCentro assistenza
Apri Screeb

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.

Guida3 min di lettura, aggiornato il 15 ott 2026

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.

  • 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.
  1. Nella barra laterale del workspace, clicca su Impostazioni, poi, sotto Dati e deployment, clicca su API Screeb.
  2. Sotto Chiave API del workspace, clicca su Copia.
  3. Consegna la chiave allo sviluppatore che configura l’integrazione, tramite un canale sicuro come il tuo password manager.
La pagina delle impostazioni dell'API Screeb, con la chiave API del workspace e il suo pulsante Copia

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.

I tuoi sviluppatori la inviano nell’header Authorization: Bearer di ogni richiesta all’API Screeb. Con essa possono:

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 se è stata compromessa o se una persona che la conosceva lascia il tuo team.

  1. 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.
  2. Clicca su Reimposta, poi su Reimposta token. La nuova chiave sostituisce subito quella vecchia. Solo gli Admin dell’organizzazione vedono Reimposta.
  3. 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.

Il tuo backend può inviare dati e Release a Screeb, e sai dove ruotare la chiave quando serve.

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.