SDK integrieren

Wechseln Sie zu einem SDK, nachdem die Verifizierung mit curl oder Bruno erfolgreich war. Bewahren Sie API-Client-Zugangsdaten in Ihrem Backend auf und nutzen Sie den bereits verifizierten Authentifizierungs- und Geräteabfrageablauf weiter.

Verfügbare SDKs

SDKs werden derzeit als Quellcode im WLTE-OpenAPI-SDK-Repository verteilt.

Sprache	Verzeichnis
TypeScript	sdk/typescript
Python	sdk/python
Go	sdk/go

git clone https://github.com/svnwi/wlte-openapi-sdk.git

Der aktuelle Funktionsumfang umfasst Authentifizierung, Geräteabfragen, Gerätetypdefinitionen, Relaissteuerung, RS485, Gerätekonfiguration und Abfrage von Befehlsergebnissen.

TypeScript

cd wlte-openapi-sdk/sdk/typescript
cp .env.example .env
npm install
npm run example:list-devices
npm run example:list-profiles

Python

cd wlte-openapi-sdk
cp sdk/python/.env.example sdk/python/.env
python3 sdk/python/examples/list_devices.py
python3 sdk/python/examples/list_profiles.py

Go

cd wlte-openapi-sdk/sdk/go
cp .env.example .env
go run ./examples/list_devices
go run ./examples/list_profiles

Checkliste für die Produktion

• Laden Sie clientId und clientSecret aus einem serverseitigen Secret-Speicher.
• Cachen Sie Access Token bis kurz vor Ablauf von expiresIn.
• Behandeln Sie den HTTP-Status und den code in der Antwort; bauen Sie Ihre Verzweigungslogik nicht auf message auf.
• Beachten Sie Retry-After und verwenden Sie begrenzte Wiederholungsversuche.
• Notieren Sie sich requestId zur Fehlerbehebung, ohne Zugangsdaten oder Token zu protokollieren.
• Verwenden Sie REST für die Basissynchronisierung und WebSocket für kontinuierliche Ereignisse, wenn nötig.

Nächste Schritte

• Integrationsanleitungen
• REST-API-Referenz (auf Englisch)
• WebSocket-Referenz (auf Englisch)
• Häufige Fehler