Tutti i 15 scope per chiavi API e connessioni AI: cosa consente ogni scope, come si chiama nella dashboard e cosa nessuna chiave API può fare.
Gli scope definiscono cosa può fare una chiave API. Gli stessi 15 scope valgono anche per gli assistenti AI che colleghi tramite MCP. Scegli sempre solo gli scope di cui un’applicazione ha davvero bisogno.
Regole di base
- Ogni endpoint richiede esattamente uno scope
- Per le chiavi API, write:X include automaticamente read:X – la dashboard lo segnala con «write:X include automaticamente read:X»
- Se manca lo scope, l’API risponde con 403 insufficient_scope e indica lo scope necessario in details.required_scope
- Anche gli endpoint non abilitati del tutto per le chiavi API rispondono con 403 insufficient_scope
- Le funzioni di proprietario e admin come membri, fatturazione o gestione dei domini non sono raggiungibili con nessuno scope
Tutti gli scope
Nella finestra di dialogo «Crea nuova chiave API» scegli «Lettura» o «Scrittura» per ogni area; l’elenco delle chiavi mostra i nomi degli scope della prima colonna. La forma «Lettura · Pagine» compare nella pagina di consenso per le app AI e in «App collegate».
| Scope | Per le app AI | Consente |
|---|---|---|
| read:pages | Lettura · Pagine | Elencare e leggere le pagine, leggere e validare la bozza, elencare i blocchi, leggere la SEO, elencare le versioni, recuperare i tipi di blocco |
| write:pages | Scrittura · Pagine | Creare e modificare pagine (handle compreso), modificare la bozza, creare, modificare, eliminare e riordinare blocchi, modificare SEO e visibilità, pubblicare, ripristinare una versione, link di invito per pagine private |
| read:links | Lettura · Link | Elencare e leggere i link di una pagina |
| write:links | Scrittura · Link | Creare, modificare, eliminare e riordinare i link |
| read:assets | Lettura · Risorse | Elencare le risorse |
| write:assets | Scrittura · Risorse | Caricare ed eliminare risorse, caricamenti per una pagina |
| read:forms | Lettura · Moduli | Leggere i moduli e il riepilogo, elencare gli invii ed esportarli in CSV (esportazione da Creator Pro) |
| write:forms | Scrittura · Moduli | Creare, modificare ed eliminare moduli |
| read:stats | Lettura · Statistiche | Statistiche di pagine e workspace (riepilogo, serie temporali, confronto, link, widget, conversioni, pagine principali), cronologia push e utilizzo push |
| read:workspaces | Lettura · Workspace | Leggere funzioni del piano, utilizzo, elenco dei membri e impostazioni del workspace, elencare i domini, elencare e leggere i modelli, elencare e leggere i secret di callback (senza il secret in chiaro) |
| write:workspaces | Scrittura · Workspace | Al momento nessun endpoint oltre a read:workspaces |
| read:donations | Lettura · Pagamenti dei sostenitori | Totali dei pagamenti dei sostenitori del workspace (pagamenti tramite il blocco «Sostieni») |
| read:short_links | Lettura · Link brevi | Elencare e leggere i link brevi |
| write:short_links | Scrittura · Link brevi | Creare, modificare ed eliminare link brevi |
| write:templates | Scrittura · Modelli del workspace | Creare, modificare ed eliminare i tuoi modelli del workspace (si leggono con read:workspaces), vedi Modelli personalizzati |
Quali endpoint appartengono esattamente a quale scope lo vedi in Endpoint dell’API per area.
Cosa nessuna chiave API può fare
- Eliminare pagine
- Creare link di anteprima per la bozza
- Suddivisioni delle statistiche per dispositivo, paese, referrer e UTM
- Inviare notifiche push e gestire le regole push
- Collegare o scollegare integrazioni
- Gestire i webhook
- Aggiungere, verificare, attivare, disattivare o eliminare domini
- Gestire membri, inviti e ruoli, trasferire la proprietà
- Modificare le impostazioni del workspace, la fatturazione
- Creare, modificare, rigenerare o eliminare secret di callback
- L’elenco dei pagamenti dei sostenitori, le richieste di accesso ai dati e l’anonimizzazione degli invii dei moduli
- Gestire il tuo profilo, le pagine che segui e le chiavi API stesse
Queste cose le fai nella dashboard.
Scope per gli assistenti AI
Per una connessione MCP scegli gli stessi scope nella pagina di consenso. Ci sono due differenze: primo, lì un’autorizzazione in scrittura non include quella in lettura – quindi concedile entrambe. Secondo, il tuo ruolo limita la scelta: i visualizzatori ottengono solo autorizzazioni in lettura (senza moduli e link brevi), gli editor tutto tranne «Scrittura · Workspace», i link brevi e i modelli del workspace. Altro in Autorizzazioni, sicurezza e limiti.
Combinazioni consigliate
| Caso d’uso | Scope |
|---|---|
| Report e dashboard | read:stats, read:pages |
| Sincronizzare link da un CMS o da uno shop | write:links, read:pages |
| Gestire e pubblicare pagine in automatico | write:pages, write:links |
| Link per campagne dal CRM | write:short_links |
| Passare i lead dai moduli al CRM | read:forms |
| Distribuire modelli da una pipeline CI | write:templates, read:workspaces |
Potrebbe esserti utile anche
Non hai trovato nulla?
Dicci di cosa hai bisogno e il nostro team di assistenza ti aiuterà personalmente.