الانتقال إلى المحتوى الرئيسي
يرسل GOWA أحداث الاقتران والأجهزة عبر /ws. يحتوي كل إطار على كائن JSON يتضمن code قابلًا للقراءة آليًا، وmessage مقروءة للمستخدم، وresult تختلف بنيته بحسب الحدث.

الاتصال

استخدم /ws ضمن APP_BASE_PATH، مثل wss://gowa.example.com/gowa/ws. اختر جهازًا باستخدام ?device_id=<id>. عند تفعيل المصادقة الأساسية، تمرّر تطبيقات المتصفح قيمة user:password بترميز base64 ثم بترميز URL في authorization. ويمكن للتطبيقات القادرة على ضبط ترويسة Authorization استخدام المصادقة الأساسية عبر تلك الترويسة. استخدم wss:// واحجب سلسلة الاستعلام في سجلات الوكيل. أضف مصدر لوحة التحكم إلى مصادر المتصفح الموثوقة في GOWA إذا كنت تستضيفها بشكل منفصل. كل مقبس متصل يتلقى كل بث ، حتى عندما يحدد الاتصال جهازًا. استخدم result.device_id لتحديد الفتحة المتأثرة عند وجودها. منح WebSocket حق الوصول فقط إلى المتصلين الموثوق بهم مع جميع الأجهزة.

حمولة الحدث

تحديث حالة الجهاز

لطلب قائمة عبر اتصال المقبس، أرسل {"code":"FETCH_DEVICES"} كإطار نصي. يبث GOWA حدث LIST_DEVICES الناتج إلى جميع اتصالات المقابس. للحصول على الحالة الحالية بعد إعادة الاتصال أو الاقتران، استدعِ GET /devices أو GET /devices/{device_id}/status. أحداث WebSocket عابرة.
راجع زوج مفتاح المرور لمكالمات REST التي تكمل طلب مفتاح المرور. استخدم webhooks لمعالجة رسائل واتسآب والإيصالات.