Integracja dla hostingów
Model organizacji, klucze API i wdrożenie u klientów.
Co możesz zautomatyzować
Lumin API pozwala tworzyć i aktualizować trasy, pobierać instrukcje DNS, uruchamiać weryfikację domen, zarządzać dostępnymi profilami i listami IP oraz odczytywać zużycie i monitoring.
API jest dostępne po HTTPS w tej samej domenie co panel, pod /v1. Zmiany konfiguracji trafiają do mechanizmu synchronizacji Lumin. Poprawna odpowiedź zapisu potwierdza przyjęcie konfiguracji, a nie zakończenie wszystkich operacji sieciowych.
Organizacja i izolacja klientów
Organizacja grupuje serwery, członków, limity i klucze. Wybierz model przed wdrożeniem:
- Jedna organizacja hostingu - zarządzanie trasami z Twojego panelu. Własny backend hostingu musi kontrolować, który klient może zmieniać daną trasę. Klucz Lumin ma uprawnienia administratora całej tej organizacji.
- Osobne organizacje klientów - oddzielne uprawnienia i limity. Każda organizacja wymaga własnego klucza lub sesji uprawnionego użytkownika.
Klucz organizacji nie tworzy nowych organizacji, nie zmienia planów i nie ma dostępu do /v1/admin/*. Utworzenie organizacji wymaga konta użytkownika i podlega jego limitowi. Model współpracy i limity ustal przed automatyzacją wdrożeń.
Zalecany przebieg wdrożenia
- Wybierz organizację i zapisz jej ID w konfiguracji integracji.
- Utwórz klucz po stronie serwerowej hostingu.
- Pobierz dostępne pule i profile.
- Utwórz trasę dla klienta. Zapisz zwrócone ID we własnej bazie.
- Pokaż klientowi rekord TXT i instrukcję DNS.
- Zweryfikuj domenę i sprawdź połączenie z backendem.
- Udostępnij klientowi status i podstawowe dane monitoringu.
Sekrety i ponowienia
Przechowuj klucze poza kodem frontendowym i logami. Używaj osobnych kluczy dla integracji, aby móc je niezależnie odwołać. API nie deklaruje obsługi Idempotency-Key: po timeoutcie tworzenia trasy najpierw sprawdź, czy zasób już powstał, zamiast bezwarunkowo ponawiać POST.