Una chiave API permette al tuo codice, a uno script o a uno strumento come Zapier di agire sul tuo account Kadens. La crei nella dashboard, scegli esattamente cosa può fare e la invii con ogni richiesta.
Una chiave è un segreto che appartiene a un solo account. Ogni richiesta effettuata con essa agisce come quell'account e può fare solo ciò che i permessi della chiave consentono.
Ogni chiave inizia con kad_ seguito da 43 caratteri casuali. Il prefisso rende facile riconoscere una chiave se finisce in un posto in cui non dovrebbe stare.
Claude e ChatGPT non hanno bisogno di una chiave: si collegano accedendo dalla pagina degli assistenti IA. Usa una chiave per script, strumenti di automazione e qualsiasi altra cosa che invii un'intestazione.
Invia la chiave nell'intestazione Authorization di ogni richiesta, come token Bearer.
Authorization: Bearer kad_...Tieni la chiave fuori dal tuo codice: conservala in una variabile d'ambiente come KADENS_API_KEY. Ogni esempio in questa documentazione la legge da lì.
Il modo più rapido per verificare che una chiave funzioni: chiedi all'API a chi appartiene.
{
"entity": {
"id": "6f1c2d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
"name": "Barcelona Salsa Studio"
},
"apiKeyId": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
"scopes": [
"webhooks.read",
"webhooks.write"
]
}Un permesso controlla un'azione precisa dell'API. Una chiave può fare solo ciò che i suoi permessi consentono, quindi assegna a ogni chiave il minor numero di permessi necessari. Un permesso di scrittura non include mai il corrispondente permesso di lettura.
| Permesso | Descrizione |
|---|---|
site.read | Leggere i contenuti del sitoVedere pagine, blocchi e impostazioni dei tuoi siti. |
site.design_reference.submit | Inviare riferimenti di designCaricare screenshot e layout che il costruttore di siti userà come guida stilistica. |
site.generate | Generare bozze del sitoCreare nuove pagine e nuovi blocchi in bozza con il costruttore di siti IA.Solo chiave API |
site.compose | Comporre i layout del sitoAggiungere, riordinare e rimuovere blocchi in una bozza. |
site.theme.configure | Configurare il tema del sitoCambiare i colori, i caratteri e le spaziature con cui è stilizzata una bozza.Solo chiave API |
site.preview.read | Vedere le anteprime del sitoAprire l'anteprima di una bozza prima che vada online. |
site.publish | Pubblicare sitiMettere online una bozza sul tuo sito pubblico. |
embed.read | Visualizzare i widget incorporatiVisualizzare i tuoi widget incorporabili, le loro statistiche, i siti web in cui sono stati visti e i domini autorizzati a mostrarli. |
embed.write | Gestire i widget incorporatiCreare, modificare e archiviare widget incorporabili e aggiungere o rimuovere i domini autorizzati a mostrarli. |
| Permesso | Descrizione |
|---|---|
catalog.read | Leggere il tuo catalogoConsultare i tuoi corsi, le loro edizioni e i piani e i prezzi con cui li vendi. |
catalog.course.write | Creare corsiAggiungere un corso al tuo catalogo, con titolo, riepilogo e lezioni. |
catalog.plan.write | Impostare i prezzi dei pianiCreare o modificare i prezzi di un piano di abbonamento di tua proprietà. |
media.import | Importare contenutiPortare un video da un URL pubblico nella tua libreria di contenuti. |
schedule.write | Impostare la tua disponibilitàCreare o sostituire l'orario settimanale da cui vengono offerte le prenotazioni. |
events.read | Leggere gli eventiVisualizza i tuoi eventi, le loro sessioni e i tipi di biglietto. |
events.write | Gestire gli eventiCrea e modifica i tuoi eventi, le loro sessioni e i tipi di biglietto. |
schedule.read | Leggere il programmaVisualizza il programma delle tue lezioni, le sue sessioni e i calendari che pubblichi. |
schedule.manage | Gestire il programmaCreare, modificare e annullare le lezioni, le sessioni e i calendari pubblicati del tuo programma. |
| Permesso | Descrizione |
|---|---|
orders.read | Leggere gli ordiniVisualizza i tuoi ordini, pagamenti e rimborsi. |
subscriptions.read | Leggere gli abbonamentiVisualizza gli abbonamenti ai tuoi piani e il loro stato. |
bookings.read | Leggere le prenotazioniVisualizza le prenotazioni delle tue lezioni e sessioni. |
payouts.read | Leggere i pagamenti ricevutiVisualizza i pagamenti che ricevi e il tuo saldo. |
pricing.write | Gestire prezzi e scontiCrea e modifica sconti, extra, offerte e le regole che decidono chi può acquistare cosa. |
orders.write | Gestire ordini e rimborsiModifica gli ordini ed emetti rimborsi. Un rimborso restituisce denaro all'acquirente. |
payments.write | Gestire i pagamentiModifica le impostazioni di pagamento, i portafogli e la riscossione del tuo account. Può spostare denaro. |
insights.read | Leggere le statisticheVisualizza le tue statistiche e i dati della tua dashboard. |
| Permesso | Descrizione |
|---|---|
attendees.read | Leggere i partecipantiVisualizza chi ha i biglietti per i tuoi eventi e i loro ingressi. |
enrollments.read | Leggere le iscrizioniVisualizza chi è iscritto ai tuoi corsi e i suoi progressi. |
people.read | Leggere i dati personaliAccedi a nomi, indirizzi email e altri dati personali dei tuoi clienti. Senza questa autorizzazione restano nascosti. |
people.write | Gestire i clientiAggiungi e modifica le persone del tuo CRM, i loro accessi e le loro richieste. |
attendees.write | Registrare i partecipantiRegistra l'entrata e l'uscita dei partecipanti ai tuoi eventi e sessioni. |
| Permesso | Descrizione |
|---|---|
webhooks.read | Visualizzare i webhookVisualizzare i tuoi endpoint webhook, il registro delle consegne e il catalogo degli eventi. |
webhooks.write | Gestire i webhookCreare, modificare e rimuovere endpoint webhook, ruotarne i segreti e inviare, reinviare o riprodurre eventi. |
| Permesso | Descrizione |
|---|---|
permissions.policy.read | Leggere le politiche dei permessiVedere cosa può fare ogni ruolo in tutto il tuo profilo. |
permissions.policy.write | Modificare le politiche dei permessiConcedere e revocare ciò che ogni ruolo può fare in tutto il tuo profilo.Solo chiave API |
actions.delegate | Agire per tuo contoConsente all'assistente di eseguire per tuo conto qualsiasi azione che puoi fare in Kadens, entro i limiti degli altri permessi che concedi. |
| Permesso | Descrizione |
|---|---|
learning.read | Leggere l'apprendimentoVisualizza esami, voti, certificati, esercitazioni consegnate e i progressi degli studenti. |
learning.write | Gestire l'apprendimentoValuta gli esami, pubblica i risultati, rilascia certificati e rivedi le esercitazioni consegnate. |
| Permesso | Descrizione |
|---|---|
community.read | Leggere la comunitàVisualizza la tua comunità, gli annunci, le chat, le recensioni e le FAQ. |
community.write | Gestire la comunitàPubblica annunci, rispondi alle chat e modera la tua comunità, le recensioni e le FAQ. |
| Permesso | Descrizione |
|---|---|
marketing.read | Leggere il marketingVisualizza i tuoi invii email, promemoria, affiliati e premi. |
marketing.write | Gestire il marketingCrea e invia email, imposta promemoria e gestisci affiliati e premi. |
| Permesso | Descrizione |
|---|---|
terms.read | Leggere le condizioni del tuo accountConsultare la commissione, i limiti e il periodo di prova concordati per il tuo account. |
settings.read | Leggere le impostazioniVisualizza il tuo profilo, i tag, le integrazioni e le impostazioni dell'account. |
settings.write | Modificare le impostazioniModifica il tuo profilo, i tag, le integrazioni e le impostazioni dell'account. |
| Argomento | Descrizione |
|---|---|
Riemetti | Crea una nuova chiave con lo stesso nome, gli stessi permessi e la stessa scadenza. La vecchia chiave smette di funzionare immediatamente, quindi aggiornala ovunque sia usata. |
Revoca | Disabilita la chiave immediatamente. Qualsiasi integrazione che la usa smette di funzionare. Questa azione non può essere annullata. |
Scadenza | Una chiave creata con una scadenza smette di funzionare in quella data. Una chiave senza scadenza funziona finché non la revochi. |
Ultimo utilizzo | La dashboard mostra quando ogni chiave è stata usata l'ultima volta. Una chiave che nessuno usa da molto tempo è una buona candidata da revocare. |
Il codice di stato dice alla tua integrazione cosa fare dopo.
| Stato | Significato |
|---|---|
401 | La chiave manca, è formattata male, è stata revocata o è scaduta. Controlla l'intestazione Authorization, oppure crea una nuova chiave. |
403 | La chiave funziona ma non ha il permesso necessario per questa richiesta. Riemettere mantiene gli stessi permessi, quindi crea invece una chiave con il permesso mancante. |
{
"statusCode": 403,
"message": "API key missing required scope",
"timestamp": "2026-10-01T10:00:00.000Z",
"path": "/api/v1/me",
"requestId": "req_7c1e0b"
}È stato utile?