Ein API-Schlüssel lässt deinen eigenen Code, ein Skript oder ein Tool wie Zapier für dein Kadens-Konto handeln. Du erstellst ihn im Dashboard, legst genau fest, was er darf, und sendest ihn mit jeder Anfrage.
Ein Schlüssel ist ein Geheimnis, das zu einem Konto gehört. Jede damit gestellte Anfrage handelt als dieses Konto und darf nur, was die Berechtigungen des Schlüssels erlauben.
Jeder Schlüssel beginnt mit kad_, gefolgt von 43 zufälligen Zeichen. Das Präfix macht einen Schlüssel leicht erkennbar, falls er dort landet, wo er nicht hingehört.
Claude und ChatGPT brauchen keinen Schlüssel: Sie verbinden sich, indem sie sich über die Seite KI-Assistenten anmelden. Verwende einen Schlüssel für Skripte, Automatisierungstools und alles andere, das einen Header sendet.
Sende den Schlüssel im Authorization-Header jeder Anfrage, als Bearer-Token.
Authorization: Bearer kad_...Halte den Schlüssel aus deinem Code heraus: Speichere ihn in einer Umgebungsvariable wie KADENS_API_KEY. Jedes Beispiel in dieser Dokumentation liest ihn von dort.
Der schnellste Weg zu prüfen, ob ein Schlüssel funktioniert: Frage die API, zu wem er gehört.
{
"entity": {
"id": "6f1c2d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
"name": "Barcelona Salsa Studio"
},
"apiKeyId": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
"scopes": [
"webhooks.read",
"webhooks.write"
]
}Eine Berechtigung ist eine einzelne Erlaubnis. Ein Schlüssel darf nur, was seine Berechtigungen erlauben, also gib jedem Schlüssel so wenige Berechtigungen wie möglich. Eine Schreibberechtigung schließt die entsprechende Leseberechtigung nie ein.
| Berechtigung | Beschreibung |
|---|---|
site.read | Website-Inhalte lesenSeiten, Blöcke und Einstellungen Ihrer Websites anzeigen. |
site.design_reference.submit | Design-Referenzen einreichenScreenshots und Layouts hochladen, die der Website-Builder als Stilvorlage verwendet. |
site.generate | Website-Entwürfe erstellenNeue Seiten und Blöcke als Entwurf mit dem KI-Website-Builder erstellen.Nur API-Schlüssel |
site.compose | Website-Layouts zusammenstellenBlöcke in einem Entwurf hinzufügen, neu anordnen und entfernen. |
site.theme.configure | Website-Design konfigurierenFarben, Schriften und Abstände ändern, mit denen ein Entwurf gestaltet wird.Nur API-Schlüssel |
site.preview.read | Website-Vorschauen ansehenDie Vorschau eines Entwurfs öffnen, bevor er live geht. |
site.publish | Websites veröffentlichenEinen Entwurf auf Ihrer öffentlichen Website live schalten. |
embed.read | Eingebettete Widgets lesenDeine einbettbaren Widgets, ihre Statistiken, die Websites, auf denen sie gesehen wurden, und die Domains ansehen, die sie anzeigen dürfen. |
embed.write | Eingebettete Widgets verwaltenEinbettbare Widgets erstellen, bearbeiten und archivieren sowie Domains hinzufügen oder entfernen, die sie anzeigen dürfen. |
| Berechtigung | Beschreibung |
|---|---|
catalog.read | Ihren Katalog lesenIhre Kurse, deren Durchgänge sowie die Pläne und Preise ansehen, mit denen Sie sie verkaufen. |
catalog.course.write | Kurse anlegenEinen Kurs mit Titel, Zusammenfassung und Lektionen zu Ihrem Katalog hinzufügen. |
catalog.plan.write | Planpreise festlegenPreise eines Abonnementplans anlegen oder ändern, der Ihnen gehört. |
media.import | Medien importierenEin Video von einer öffentlichen URL in Ihre Mediathek holen. |
schedule.write | Ihre Verfügbarkeit festlegenDen wöchentlichen Zeitplan anlegen oder ersetzen, aus dem Buchungen angeboten werden. |
events.read | Events lesenSieh deine Events, ihre Termine und Ticketarten ein. |
events.write | Events verwaltenErstelle und ändere deine Events, ihre Termine und Ticketarten. |
schedule.read | Zeitplan lesenSieh den Zeitplan deiner Kurse, seine Termine und die Kalender ein, die du veröffentlichst. |
schedule.manage | Zeitplan verwaltenKurse, Termine und veröffentlichte Kalender in deinem Zeitplan anlegen, ändern und absagen. |
| Berechtigung | Beschreibung |
|---|---|
orders.read | Bestellungen lesenSieh deine Bestellungen, Zahlungen und Erstattungen ein. |
subscriptions.read | Abonnements lesenSieh die Abonnements deiner Pläne und ihren Status ein. |
bookings.read | Buchungen lesenSieh die Buchungen deiner Kurse und Termine ein. |
payouts.read | Auszahlungen lesenSieh deine Auszahlungen und dein Guthaben ein. |
pricing.write | Preise und Rabatte verwaltenErstelle und ändere Rabatte, Zusatzleistungen, Angebote und die Regeln, wer was kaufen darf. |
orders.write | Bestellungen und Erstattungen verwaltenÄndere Bestellungen und erstatte Beträge. Eine Erstattung überweist Geld an den Käufer zurück. |
payments.write | Zahlungen verwaltenÄndere Zahlungseinstellungen, Guthaben und wie dein Konto Zahlungen einzieht. Dabei kann Geld bewegt werden. |
insights.read | Statistiken lesenSieh deine Statistiken und die Zahlen deines Dashboards ein. |
| Berechtigung | Beschreibung |
|---|---|
attendees.read | Teilnehmende lesenSieh ein, wer Tickets für deine Events hat und wer eingecheckt ist. |
enrollments.read | Einschreibungen lesenSieh ein, wer in deinen Kursen eingeschrieben ist und wie weit sie sind. |
people.read | Personenbezogene Daten lesenSieh Namen, E-Mail-Adressen und andere personenbezogene Daten deiner Kundschaft. Ohne diese Berechtigung bleiben sie verborgen. |
people.write | Kunden verwaltenFüge Personen in deinem CRM hinzu und ändere sie, ihre Zugänge und ihre Anfragen. |
attendees.write | Teilnehmer eincheckenChecke Teilnehmer deiner Events und Termine ein und aus. |
| Berechtigung | Beschreibung |
|---|---|
webhooks.read | Webhooks lesenDeine Webhook-Endpunkte, ihr Zustellprotokoll und den Ereigniskatalog ansehen. |
webhooks.write | Webhooks verwaltenWebhook-Endpunkte erstellen, bearbeiten und entfernen, ihre Secrets rotieren und Ereignisse senden, erneut senden oder wiederholen. |
| Berechtigung | Beschreibung |
|---|---|
permissions.policy.read | Berechtigungsregeln lesenAnzeigen, was jede Rolle in Ihrem gesamten Profil tun darf. |
permissions.policy.write | Berechtigungsregeln ändernErteilen und entziehen, was jede Rolle in Ihrem gesamten Profil tun darf.Nur API-Schlüssel |
actions.delegate | In Ihrem Namen handelnErlaubt dem Assistenten, jede Aktion, die Sie in Kadens ausführen können, in Ihrem Namen auszuführen, begrenzt durch die anderen Berechtigungen, die Sie erteilen. |
| Berechtigung | Beschreibung |
|---|---|
learning.read | Lerndaten lesenSieh Prüfungen, Bewertungen, Zertifikate, eingereichte Übungen und den Fortschritt deiner Lernenden ein. |
learning.write | Lernen verwaltenBewerte Prüfungen, veröffentliche Ergebnisse, stelle Zertifikate aus und prüfe eingereichte Übungen. |
| Berechtigung | Beschreibung |
|---|---|
community.read | Community lesenSieh deine Community, Ankündigungen, Chats, Bewertungen und FAQs ein. |
community.write | Community verwaltenVeröffentliche Ankündigungen, beantworte Chats und moderiere deine Community, Bewertungen und FAQs. |
| Berechtigung | Beschreibung |
|---|---|
marketing.read | Marketing lesenSieh deine Mailings, Erinnerungen, Affiliates und Prämien ein. |
marketing.write | Marketing verwaltenErstelle und versende Mailings, richte Erinnerungen ein und verwalte Affiliates und Prämien. |
| Berechtigung | Beschreibung |
|---|---|
terms.read | Ihre Kontokonditionen lesenProvision, Limits und Testzeitraum ansehen, die für Ihr Konto vereinbart wurden. |
settings.read | Einstellungen lesenSieh dein Profil, deine Tags, Integrationen und Kontoeinstellungen ein. |
settings.write | Einstellungen ändernÄndere dein Profil, deine Tags, Integrationen und Kontoeinstellungen. |
| Thema | Beschreibung |
|---|---|
Neu ausstellen | Erstellt einen neuen Schlüssel mit demselben Namen, denselben Berechtigungen und demselben Ablauf. Der alte Schlüssel funktioniert sofort nicht mehr, aktualisiere ihn also überall, wo er verwendet wird. |
Widerrufen | Deaktiviert den Schlüssel sofort. Jede Integration, die ihn verwendet, funktioniert nicht mehr. Dies kann nicht rückgängig gemacht werden. |
Ablauf | Ein mit Ablauf erstellter Schlüssel funktioniert ab diesem Datum nicht mehr. Ein Schlüssel ohne Ablauf funktioniert, bis du ihn widerrufst. |
Zuletzt verwendet | Das Dashboard zeigt, wann jeder Schlüssel zuletzt verwendet wurde. Ein Schlüssel, den lange niemand verwendet hat, ist ein guter Kandidat zum Widerrufen. |
Der Statuscode sagt deiner Integration, was als Nächstes zu tun ist.
| Status | Bedeutung |
|---|---|
401 | Der Schlüssel fehlt, ist falsch formatiert, widerrufen oder abgelaufen. Prüfe den Authorization-Header oder erstelle einen neuen Schlüssel. |
403 | Der Schlüssel funktioniert, hat aber nicht die für diese Anfrage nötige Berechtigung. Da eine Neuausstellung dieselben Berechtigungen behält, erstelle stattdessen einen Schlüssel mit der fehlenden Berechtigung. |
{
"statusCode": 403,
"message": "API key missing required scope",
"timestamp": "2026-10-01T10:00:00.000Z",
"path": "/api/v1/me",
"requestId": "req_7c1e0b"
}War das hilfreich?