Integrar un SDK

Pasa a un SDK cuando la verificación con curl o con Bruno funcione. Mantén las credenciales del API Client en tu backend y reutiliza el flujo de autenticación y consulta de dispositivos que ya has validado.

SDK disponibles

Ahora mismo los SDK se distribuyen como código fuente en el repositorio del SDK de WLTE OpenAPI.

Lenguaje	Directorio
TypeScript	sdk/typescript
Python	sdk/python
Go	sdk/go

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

La cobertura actual incluye autenticación, consultas de dispositivo, definiciones de tipo de dispositivo, control de relés, RS485, configuración del dispositivo y consulta del resultado de comandos.

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

Lista de comprobación para producción

• Carga el clientId y el clientSecret desde el almacén de secretos del servidor.
• Cachea los access token hasta poco antes de que venza expiresIn.
• Trata el estado HTTP y el code de la respuesta; no ramifiques según message.
• Respeta Retry-After y usa reintentos acotados.
• Registra el requestId para depurar, sin escribir credenciales ni tokens en los registros.
• Usa REST para la sincronización de base y WebSocket para los eventos continuos cuando los necesites.

Siguientes pasos

• Guías de integración
• Referencia de REST API (en inglés)
• Referencia de WebSocket (en inglés)
• Fallos habituales