Handlung erforderlich: Stellen Sie Ihre Anbindung an die öffentliche Luminovo API bis zum 7. August 2025 um, um Unterbrechungen Ihres Betriebs zu vermeiden.
Einführung
Bislang gab es zwei Wege, auf die REST-API von Luminovo zuzugreifen.
Legacy-URL {tenant-name}.luminovo.com/api
Neue URL api.luminovo.com
Um maximale Stabilität für bestehende API-Endpunkte zu gewährleisten, bitten wir alle Nutzer*innen, auf die neue API umzustellen. Diese Migration hilft unserem Engineering-Team, sich auf die Veröffentlichung neuer und stabilerer Endpunkte zu konzentrieren.
Wir rechnen mit etwa 2–3 Stunden Entwicklungsaufwand auf Ihrer Seite.
Erforderliche Änderungen:
Auf die neue Authentifizierungsmethode umstellen
Anfrage-URLs aktualisieren
Accept-Header für die Datenmodell-Versionierung prüfen
1. Auf die neue Authentifizierungsmethode umstellen
Die neue Authentifizierungsmethode nutzt weiterhin Bearer-Tokens, vereinfacht den Prozess aber. Sie ist in unserer API-Dokumentation unter Authentication dokumentiert.
Die neue Authentifizierungsmethode nutzt weiterhin Bearer-Tokens für Anfragen an die Luminovo API. Zuvor waren client_id und client_secret erforderlich. Jetzt benötigen Sie nur noch ein geheimes token.
Beispiele: alte vs. neue Authentifizierung
Alte Authentifizierungsmethode
curl --request POST \
--url "https://{tenant}.luminovo.com/api/token" \
--header 'content-type: application/json' \
--data '{
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}'
Mit einer Beispielantwort:
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
"token_type": "bearer",
"expires_in": 3600
}
Neue Authentifizierungsmethode
curl --request POST \
--url "https://api.luminovo.com/token" \
--header 'content-type: application/json' \
--data '{
"token": "cb7daea2-df5f-44de-99cc-213668e6c991"
}'
Die Antwort enthält nur einen String mit dem Token:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
Schritte zur Migration:
Fordern Sie Ihr neues API-Token über den Support-Chat in Luminovo an
Aktualisieren Sie Ihren Authentifizierungscode (siehe Dokumentation)
Stellen Sie sicher, dass Sie das Bearer-Token korrekt aus der Antwort extrahieren
2. Anfrage-URLs aktualisieren
Ändern Sie einfach alle Endpunkte von:
{tenant}.luminovo.com/api/{endpoint} zu api.luminovo.com/{endpoint}
Vergleichen Sie Ihre Implementierung mit unserer API-Dokumentation, um sicherzustellen, dass Sie die neuesten Parameter und Datenmodelle verwenden. Siehe unsere öffentliche API-Dokumentation.
3. Accept-Header prüfen
Stellen Sie sicher, dass Ihre Anfragen den passenden Accept-Header enthalten, um die Datenmodell-Version anzugeben: Accept: application/api.luminovo.[resource]-v1+json. Für einige Endpunkte ist dieser Header nicht erforderlich.
Dieser Header stellt sicher, dass Sie Antworten im erwarteten Format erhalten, auch während wir die API weiterentwickeln.
Test und Zeitplan
Die Legacy-API bleibt bis zum 7. August 2025 erreichbar
Wir empfehlen, die neue API zuerst in einer Nicht-Produktivumgebung zu testen
Beginnen Sie mit unkritischen Endpunkten mit geringem Volumen, bevor Sie kritische Funktionen migrieren
Fragen
Bei Fragen zu den technischen Details der Umstellung auf die neue öffentliche API wenden Sie sich bitte an [email protected]