دمج 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 (بالإنجليزية)
• الأعطال الشائعة