Zużycie, plany i monitoring

Lumin Shield ↗Otwórz panel ↗

Odczyt limitów i aktywności serwerów.

Plan i wykorzystanie

Metoda	Ścieżka	Dostęp
GET	/v1/plans	Publiczny katalog planów.
GET	/v1/orgs/{org}/subscription	member; bieżący plan organizacji.
GET	/v1/orgs/{org}/usage	member; wykorzystanie transferu.

Dla zużycia dostępne są parametry from, to w formacie YYYY-MM-DD i opcjonalne routeId. Bez dat API wybiera bieżący miesiąc w UTC. Nie zapisuj cen i limitów na stałe w integracji.

curl --fail-with-body \
  "https://lumin.edu.pl/v1/orgs/$LUMIN_ORG_ID/usage?from=2026-09-01&to=2026-09-30" \
  -H "Authorization: Bearer $LUMIN_API_KEY"

Do wykorzystania planu liczy się ruch przekazany do backendu. Zablokowane połączenia i pingi statusu są wykluczone.

Monitoring

GET /v1/orgs/{org}/routes/{id}/monitoring wymaga roli admin. Odpowiedź zawiera m.in. online, sources, freshSources, updatedAt, since, truncated, players, events, points i protocolNames.

online: null oznacza brak świeżych danych. Uwzględniaj updatedAt i freshSources, aby nie prezentować starego odczytu jako bieżącego. Nie odpytuj częściej niż co 5 sekund.

Zgłoszenia błędnych odrzuceń są dostępne przez POST /v1/orgs/{org}/routes/{id}/false-positives. Najpierw wybierz faktyczne zdarzenie w panelu. Zgłoszenia podlegają limitom i wykrywaniu duplikatów; nie używaj ich do automatycznego zgłaszania każdego odrzucenia.