Autoryzacja API
Klucze organizacji, nagłówki i pierwsze zapytanie.
Adres API
Użyj publicznego adresu panelu: https://lumin.edu.pl/v1. Przykłady zakładają klucz organizacji zapisany w zmiennej środowiskowej LUMIN_API_KEY na Twoim backendzie.
curl --fail-with-body https://lumin.edu.pl/v1/orgs \
-H "Authorization: Bearer $LUMIN_API_KEY"
Utwórz klucz
W organizacji otwórz Klucze API, nadaj kluczowi nazwę integracji i skopiuj sekret. Pełny klucz jest pokazywany tylko przy utworzeniu. Po utracie utwórz nowy i odwołaj stary.
Nagłówek ma postać Authorization: Bearer sak_.... Dla żądań z JSON dodaj Content-Type: application/json.
Uprawnienia
Klucz działa jako administrator jednej organizacji. Może konfigurować jej zasoby. Nie jest kontem użytkownika ani administratorem platformy. Nie wysyłaj klucza do przeglądarki gracza lub klienta hostingu.
| Operacja | Klucz organizacji |
|---|---|
| Odczyt i konfiguracja własnych tras | Tak |
| Monitoring i wykorzystanie planu | Tak |
| Odczyt innych organizacji | Nie |
| Utworzenie organizacji | Nie |
| Zmiana roli wymagająca właściciela | Nie |
| Administracja platformą | Nie |
Sesje użytkownika
Logowanie konta zwraca krótko żyjący access token i rotowany refresh token. To inny mechanizm niż stały klucz integracji. Dla procesów serwerowych hostingu używaj klucza API; nie automatyzuj logowania hasłem administratora.