eLearning.edu.pl API
ENPL

Pierwsze kroki

API integracji eLearning.edu.pl pozwala systemowi kadrowemu, dostawcy tożsamości albo narzędziu raportowemu wymieniać z platformą dane o osobach, przydziałach szkoleń i stanie zgodności.

1. Uzyskaj dane dostępowe

Poproś administratora IT swojej organizacji o utworzenie klienta integracji w panelu administracji IT. Administrator wybiera:

  • zakresy (scopes) — co klient może robić (users:read, users:write, enrollments:write, compliance:read, webhooks:manage, scim);
  • metody uwierzytelniania — klucz API, OAuth 2.0 client credentials albo obie;
  • opcjonalnie listę dozwolonych adresów IP i datę ważności.

Otrzymujesz identyfikator klienta i sekret w postaci lms_live_<12 znaków>_<32 znaki>. Sekret jest pokazywany tylko raz — zapisz go w menedżerze sekretów.

Potrzebujesz też kodu organizacji (tenant code) — identyfikatora Twojej organizacji widocznego w panelu IT.

2. Wykonaj pierwsze wywołanie

BASE_URL="${BASE_URL:-https://api.elearning.edu.pl}"

curl --fail-with-body -sS "$BASE_URL/api/v1/users?limit=5" \
  -H "X-Tenant-Code: $TENANT_CODE" \
  -H "X-API-Key: $API_KEY"

Każde żądanie wymaga nagłówka X-Tenant-Code (SCIM: kod organizacji jest częścią ścieżki). Adres API nie zmienia się, nawet gdy Twoja organizacja zostanie przeniesiona do innego węzła centrum danych, więc możesz go wpisać na stałe.

3. Co dalej

  • Uwierzytelnianie — klucz API a tokeny OAuth 2.0.
  • Typowy przepływ — synchronizacja osób, przydział szkoleń, odczyt zgodności.
  • Webhooki — powiadomienia o ukończeniach i wygaśnięciach zamiast odpytywania.
  • Limity i błędy — klient, który poprawnie ponawia żądania.

Testowanie API

Używaj organizacji testowej, oddzielonej od danych produkcyjnych — poproś o nią opiekuna wdrożenia. Utwórz klienta integracji w jej panelu IT i wywołuj API z jej kodem organizacji.