Integracje API i agenci AI

Klucz API pozwala Twojemu oprogramowaniu — systemowi HR, skryptowi raportowemu albo agentowi AI — pracować na danych organizacji bez logowania się człowieka. Klucz należy do organizacji, a nie do Ciebie, więc działa dalej po zmianie pracy, a unieważnisz go jednym kliknięciem.

Kto może to zrobić

Dostępne dla administratorów organizacji. Otwórz Ustawienia organizacji → Integracje. Deweloperzy tworzą swoje klucze w Aplikacje → Integracje.

Zobacz swoje klucze

Karta Klucze API pokazuje każdy klucz organizacji z kolumnami Zakres, Role, Ważny do, Ostatnie użycie i Status (Aktywny, Unieważniony albo Wygasły). Pod nazwą widać tylko początek klucza, nigdy całą wartość.

Karta Klucze API z kluczami aktywnymi i unieważnionym

Utwórz klucz

1Otwórz Ustawienia organizacji → Integracje.
2Kliknij Utwórz klucz.
3W polu Nazwa nazwij go od narzędzia, które go użyje — tę nazwę zobaczysz w dzienniku żądań.
4W sekcji Role wybierz, co dostaje klucz: Administrator, Analityk albo Administrator urządzeń. Klucz nigdy nie może więcej niż Ty, więc widzisz tylko role, które masz na swoim koncie.
5W sekcji Zakres wybierz Tylko odczyt albo Odczyt i zapis.
6W sekcji Ważność wybierz 30, 90 albo 365 dni.
7Kliknij Utwórz klucz.

Klucz pokazujemy raz, zaraz po utworzeniu. Skopiuj go do menedżera haseł albo sejfu sekretów, zanim zamkniesz okno. Jeśli go zgubisz, wymień klucz i używaj nowego.

Traktuj klucz jak hasło

Kto go ma, czyta dane organizacji w zakresie ról nadanych kluczowi. Nigdy nie wklejaj go na czat, do zgłoszenia ani do publicznego repozytorium.

Jak wygląda klucz

Każdy klucz zaczyna się od sk_live_, na przykład sk_live_7Hq2mZk1_…. Panel przechowuje tylko jego skrót i widoczny prefiks — dlatego nie możemy pokazać pełnego klucza drugi raz.

Wysyłaj go w nagłówku Authorization:

Authorization: Bearer sk_live_7Hq2mZk1_…

Role i zakres

Role decydują, jakie dane klucz widzi — dokładnie tak samo jak dla człowieka w tej roli.
Zakres decyduje, co może zrobić: klucz tylko do odczytu dostaje 403 przy każdym zapisie.
Klucz działa wyłącznie w organizacji, w której powstał. Do panelu (api/web) nie ma dostępu w ogóle.

Ważność i wymiana klucza

Klucz przestaje działać w momencie wygaśnięcia. Obie poniższe akcje są w menu na końcu wiersza aktywnego klucza.

Wymień klucz daje nową wartość klucza, a stary działa jeszcze 24 godziny — tyle, ile trzeba na wdrożenie nowej wartości w narzędziu bez przerwy w działaniu.
Unieważnij kończy życie klucza natychmiast: każde wywołanie jest odrzucane w ciągu minuty. Tego nie da się cofnąć.

Menu wiersza klucza API z opcjami Wymień klucz i Unieważnij

Limity

10 aktywnych kluczy na organizację i kontekst.
120 żądań na minutę na klucz. Powyżej tego API odpowiada 429 z nagłówkiem Retry-After.

Dziennik żądań

Karta Dziennik żądań na tej samej stronie pokazuje każde wywołanie kluczem tej organizacji: klucz, metodę i ścieżkę, status odpowiedzi, czas i to, czy przyszło przez REST czy MCP. Przy diagnozie integracji filtruj go polami Klucz i Status — 429 oznacza, że klucz przekroczył limit żądań. Wpisy przechowujemy przez 90 dni.

Dokumentacja API

Pełną listę endpointów oraz kształt żądań i odpowiedzi znajdziesz w dokumentacji API: api.skillsive.com/core/docs/v1. Przycisk Dokumentacja API na stronie Integracje otwiera tę samą stronę.

Podłącz agenta AI (MCP)

Ten sam klucz uwierzytelnia Cię na serwerze MCP Skillsive pod https://api.skillsive.com/core/mcp, który wystawia API jako narzędzia wołane wprost przez agenta.

Claude Code — jedna komenda w terminalu:

claude mcp add --transport http skillsive https://api.skillsive.com/core/mcp --header "Authorization: Bearer sk_live_…"

Cursor — dopisz serwer do ~/.cursor/mcp.json (albo .cursor/mcp.json w projekcie):

{
	"mcpServers": {
		"skillsive": {
			"type": "http",
			"url": "https://api.skillsive.com/core/mcp",
			"headers": { "Authorization": "Bearer sk_live_…" }
		}
	}
}

Konektory Claude.ai i ChatGPT

Konektory w aplikacjach webowych Claude i ChatGPT wymagają logowania OAuth, którego Skillsive jeszcze nie obsługuje. Agenci uwierzytelniani nagłówkiem — Claude Code, Cursor i Twoi właśni agenci — działają już dziś.

FAQ

Okno zamknęło się przed skopiowaniem klucza. Czy zobaczę go jeszcze raz?

Nie — przechowujemy tylko jego skrót. Otwórz menu klucza, kliknij Wymień klucz i skopiuj nową wartość.

Jaką rolę dać systemowi HR albo narzędziu do raportów?

Administrator. Odczyt kursantów, ukończeń kursów i certyfikatów wymaga klucza z rolą Administrator — klucz z rolą Analityk odczyta tylko podstawowe dane organizacji. Aby klucz nie mógł niczego zmienić, nadaj mu zakres Tylko odczyt.

Czy klucz przestaje działać, gdy osoba, która go utworzyła, odejdzie z firmy?

Nie. Klucz należy do organizacji. Unieważnij go, gdy narzędzie przestanie być używane.