Интеграция SDK

Переходите на SDK после успешной проверки через curl или Bruno. Храните учётные данные API Client на своём бэкенде и переиспользуйте уже проверенный поток аутентификации и запроса устройств.

Доступные SDK

Сейчас SDK распространяются в виде исходного кода в репозитории WLTE OpenAPI SDK.

Язык	Директория
TypeScript	sdk/typescript
Python	sdk/python
Go	sdk/go

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

Текущий охват включает аутентификацию, запросы устройств, определения типов устройств, управление реле, RS485, конфигурацию устройств и получение результатов команд.

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

Чек-лист для продакшна

• Загружайте clientId и clientSecret из хранилища секретов на стороне сервера.
• Кэшируйте access token до момента незадолго до истечения expiresIn.
• Обрабатывайте статус HTTP и code в ответе; не стройте логику ветвления на message.
• Соблюдайте Retry-After и используйте ограниченное число повторных попыток.
• Записывайте requestId для решения проблем, не логируя учётные данные или токены.
• Используйте REST для базовой синхронизации и WebSocket для непрерывных событий, когда это нужно.

Следующие шаги

• Руководства по интеграции
• Справочник REST API (на английском)
• Справочник WebSocket (на английском)
• Частые сбои