Klucz API pozwala Twojemu kodowi, skryptowi lub narzędziu takiemu jak Zapier działać w Twoim koncie Kadens. Tworzysz go w panelu, wybierasz dokładnie, co może robić, i wysyłasz z każdym żądaniem.
Klucz to sekret należący do jednego konta. Każde żądanie wykonane za jego pomocą działa jako to konto i może zrobić tylko to, na co pozwalają uprawnienia klucza.
Każdy klucz zaczyna się od kad_, po którym następuje 43 losowych znaków. Prefiks ułatwia rozpoznanie klucza, jeśli trafi tam, gdzie nie powinien.
Claude i ChatGPT nie potrzebują klucza: łączą się, logując się ze strony asystentów AI. Klucza używaj do skryptów, narzędzi do automatyzacji i wszystkiego innego, co wysyła nagłówek.
Wysyłaj klucz w nagłówku Authorization każdego żądania, jako token Bearer.
Authorization: Bearer kad_...Trzymaj klucz poza kodem: przechowuj go w zmiennej środowiskowej, na przykład KADENS_API_KEY. Każdy przykład w tej dokumentacji odczytuje go stamtąd.
Najszybszy sposób sprawdzenia, czy klucz działa: zapytaj API, do kogo należy.
{
"entity": {
"id": "6f1c2d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
"name": "Barcelona Salsa Studio"
},
"apiKeyId": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
"scopes": [
"webhooks.read",
"webhooks.write"
]
}Uprawnienie kontroluje jedno konkretne działanie API. Klucz może zrobić tylko to, na co pozwalają jego uprawnienia, więc nadawaj każdemu kluczowi jak najmniej uprawnień. Uprawnienie do zapisu nigdy nie obejmuje odpowiadającego mu uprawnienia do odczytu.
| Uprawnienie | Opis |
|---|---|
site.read | Odczyt treści stronyPrzeglądanie podstron, bloków i ustawień Twoich stron. |
site.design_reference.submit | Przesyłanie referencji projektowychPrzesyłanie zrzutów ekranu i layoutów, których kreator stron użyje jako wzorca stylistycznego. |
site.generate | Generowanie szkiców stronyTworzenie nowych podstron i bloków jako szkiców za pomocą kreatora stron AI.Tylko klucz API |
site.compose | Komponowanie układu stronyDodawanie, zmiana kolejności i usuwanie bloków w szkicu. |
site.theme.configure | Konfigurowanie motywu stronyZmiana kolorów, czcionek i odstępów, którymi stylizowany jest szkic.Tylko klucz API |
site.preview.read | Odczyt podglądów stronyOtwieranie podglądu szkicu, zanim zostanie opublikowany. |
site.publish | Publikowanie stronPublikowanie szkicu na Twojej publicznej stronie. |
embed.read | Odczyt osadzonych widżetówPrzeglądanie osadzanych widżetów, ich statystyk, stron internetowych, na których się pojawiły, oraz domen, które mogą je wyświetlać. |
embed.write | Zarządzanie osadzonymi widżetamiTworzenie, edycja i archiwizacja osadzanych widżetów oraz dodawanie i usuwanie domen, które mogą je wyświetlać. |
| Uprawnienie | Opis |
|---|---|
catalog.read | Odczyt twojego kataloguPrzeglądanie twoich kursów, ich edycji oraz planów i cen, po których je sprzedajesz. |
catalog.course.write | Tworzenie kursówDodanie kursu do twojego katalogu wraz z tytułem, opisem i lekcjami. |
catalog.plan.write | Ustawianie cen planówTworzenie lub zmiana cen planu subskrypcji, który należy do ciebie. |
media.import | Import multimediówPobranie filmu z publicznego adresu URL do twojej biblioteki multimediów. |
schedule.write | Ustawianie twojej dostępnościUtworzenie lub zastąpienie tygodniowego harmonogramu, z którego oferowane są rezerwacje. |
events.read | Odczyt wydarzeńPrzeglądaj swoje wydarzenia, ich terminy i rodzaje biletów. |
events.write | Zarządzanie wydarzeniamiTwórz i zmieniaj swoje wydarzenia, ich terminy i rodzaje biletów. |
schedule.read | Odczyt harmonogramuPrzeglądaj harmonogram swoich zajęć, jego terminy i publikowane kalendarze. |
schedule.manage | Zarządzanie harmonogramemTworzenie, zmiana i odwoływanie zajęć, terminów i publikowanych kalendarzy w twoim harmonogramie. |
| Uprawnienie | Opis |
|---|---|
orders.read | Odczyt zamówieńPrzeglądaj swoje zamówienia, płatności i zwroty. |
subscriptions.read | Odczyt subskrypcjiPrzeglądaj subskrypcje Twoich planów i ich status. |
bookings.read | Odczyt rezerwacjiPrzeglądaj rezerwacje Twoich zajęć i sesji. |
payouts.read | Odczyt wypłatPrzeglądaj swoje wypłaty i saldo. |
pricing.write | Zarządzanie cenami i zniżkamiTwórz i zmieniaj zniżki, dodatki, oferty oraz zasady decydujące, kto może co kupić. |
orders.write | Zarządzanie zamówieniami i zwrotamiZmieniaj zamówienia i wystawiaj zwroty. Zwrot oddaje pieniądze kupującemu. |
payments.write | Zarządzanie płatnościamiZmieniaj ustawienia płatności, portfele i sposób pobierania płatności na koncie. Może to przenosić pieniądze. |
insights.read | Odczyt statystykPrzeglądaj swoje statystyki i liczby z panelu. |
| Uprawnienie | Opis |
|---|---|
attendees.read | Odczyt uczestnikówSprawdzaj, kto ma bilety na Twoje wydarzenia i kto został wpuszczony. |
enrollments.read | Odczyt zapisówSprawdzaj, kto jest zapisany na Twoje kursy i jakie robi postępy. |
people.read | Odczyt danych osobowychZobacz imiona, adresy e-mail i inne dane osobowe Twoich klientów. Bez tego uprawnienia są ukryte. |
people.write | Zarządzanie klientamiDodawaj i zmieniaj osoby w swoim CRM, ich dostępy i ich prośby. |
attendees.write | Rejestracja uczestnikówRejestruj wejście i wyjście uczestników swoich wydarzeń i terminów. |
| Uprawnienie | Opis |
|---|---|
webhooks.read | Odczyt webhookówPrzeglądanie punktów końcowych webhooków, dziennika dostarczeń i katalogu zdarzeń. |
webhooks.write | Zarządzanie webhookamiTworzenie, edycja i usuwanie punktów końcowych webhooków, rotacja ich sekretów oraz wysyłanie, ponowne wysyłanie i odtwarzanie zdarzeń. |
| Uprawnienie | Opis |
|---|---|
permissions.policy.read | Odczyt polityk uprawnieńPrzeglądanie tego, co każda rola może robić w całym Twoim profilu. |
permissions.policy.write | Zmiana polityk uprawnieńPrzyznawanie i odbieranie tego, co każda rola może robić w całym Twoim profilu.Tylko klucz API |
actions.delegate | Działanie w Twoim imieniuPozwala asystentowi wykonać w Twoim imieniu każdą czynność, którą możesz wykonać w Kadens, w granicach pozostałych przyznanych przez Ciebie uprawnień. |
| Uprawnienie | Opis |
|---|---|
learning.read | Odczyt danych naukiPrzeglądaj egzaminy, oceny, certyfikaty, oddane ćwiczenia i postępy kursantów. |
learning.write | Zarządzanie naukąOceniaj egzaminy, publikuj wyniki, wystawiaj certyfikaty i sprawdzaj oddane ćwiczenia. |
| Uprawnienie | Opis |
|---|---|
community.read | Odczyt społecznościPrzeglądaj swoją społeczność, ogłoszenia, czaty, opinie i FAQ. |
community.write | Zarządzanie społecznościąPublikuj ogłoszenia, odpowiadaj na czatach i moderuj swoją społeczność, opinie i FAQ. |
| Uprawnienie | Opis |
|---|---|
marketing.read | Odczyt marketinguPrzeglądaj swoje wysyłki e-mail, przypomnienia, partnerów afiliacyjnych i nagrody. |
marketing.write | Zarządzanie marketingiemTwórz i wysyłaj e-maile, ustawiaj przypomnienia oraz zarządzaj partnerami afiliacyjnymi i nagrodami. |
| Uprawnienie | Opis |
|---|---|
terms.read | Odczyt warunków twojego kontaPrzeglądanie prowizji, limitów i okresu próbnego uzgodnionych dla twojego konta. |
settings.read | Odczyt ustawieńPrzeglądaj swój profil, tagi, integracje i ustawienia konta. |
settings.write | Zmiana ustawieńZmieniaj swój profil, tagi, integracje i ustawienia konta. |
| Temat | Opis |
|---|---|
Wydaj ponownie | Tworzy nowy klucz o tej samej nazwie, tych samych uprawnieniach i terminie wygaśnięcia. Stary klucz przestaje działać natychmiast, więc zaktualizuj go wszędzie, gdzie jest używany. |
Unieważnij | Natychmiast wyłącza klucz. Każda integracja, która go używa, przestaje działać. Tej operacji nie można cofnąć. |
Wygaśnięcie | Klucz utworzony z terminem wygaśnięcia przestaje działać tego dnia. Klucz bez terminu działa, dopóki go nie unieważnisz. |
Ostatnie użycie | Panel pokazuje, kiedy każdy klucz był ostatnio używany. Klucz, którego od dawna nikt nie użył, to dobry kandydat do unieważnienia. |
Kod statusu mówi Twojej integracji, co zrobić dalej.
| Status | Znaczenie |
|---|---|
401 | Klucz jest brakujący, źle sformatowany, unieważniony lub wygasły. Sprawdź nagłówek Authorization albo utwórz nowy klucz. |
403 | Klucz działa, ale brakuje mu uprawnienia potrzebnego do tego żądania. Wydanie ponowne zachowuje te same uprawnienia, więc zamiast tego utwórz klucz z brakującym uprawnieniem. |
{
"statusCode": 403,
"message": "API key missing required scope",
"timestamp": "2026-10-01T10:00:00.000Z",
"path": "/api/v1/me",
"requestId": "req_7c1e0b"
}Czy to pomogło?