الانتقال إلى المحتوى الرئيسي
يدعم GOWA HTTP Basic Auth ولا شيء آخر: لا توجد مفاتيح API أو رموز لحاملها أو JWT ل REST API. (MCP يمكن أن تقبل إضافة إلى ذلك رمز OAuth tokens؛ انظر MCP server.)

تكوين

كل زوج user:pass في القائمة المفصولة بفواصل هو بيانات تسجيل دخول صالحة. يجب أن يحتوي كل إدخال على اسم مستخدم وكلمة مرور معًا. يرفض المستمع على عنوان غير عنوان الاسترجاع المحلي بدء التشغيل دون بيانات اعتماد كاملة. اضبط الربط على APP_HOST=127.0.0.1 للتطوير المحلي دون مصادقة. استخدم APP_ALLOW_UNAUTHENTICATED=true فقط عندما يتولى وكيل عكسي مصادقة المتصلين ويكون الوصول المباشر إلى GOWA مقيّدًا.

إرسال بيانات الاعتماد

تؤدي بيانات الاعتماد غير الصحيحة أو المفقودة إلى إرجاع 401 Unauthorized.

المسارات العامة

WebSocket

لا يمكن للمتصفحات تعيين رؤوس على اتصالات WebSocket، لذا /ws يقبل أيضًا /ws?device_id=my-device&authorization=<base64 user:pass>. استخدم wss:// و redact أوراق اعتماد من سجلات البروكسي. إن مسارات HTTP و WebSocket المتغيرة للحالة ترفض منشأ المتصفح غير الموثوق به. قم بتعيين أصل لوحة التحكم بالضبط في APP_TRUSTED_ORIGINS أو APP_CORS_ALLOWED_ORIGINS. مصدر البطاقة البرية CORS لا يمنح هذا الوصول، وأصولها null من صفحات file:// مرفوضة. طفرات HTTP من أصل غير موثوق به العائد 403 CROSS_SITE_REQUEST_BLOCKED. انظر تكوين الوصول إلى المتصفح.

رأس الجهاز

المصادقة الأساسية تحدد متصل API، وليس حساب WhatsApp. كل مكالمة على نطاق الجهاز تحتاج أيضًا إلى X-Device-Id عندما يكون هناك أكثر من جهاز واحد. انظر Multi-device.
ترسل المصادقة الأساسية بيانات الاعتماد على كل طلب. استخدم دائما HTTPS أمام GOWA خارج شبكة موثوق بها.