> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# مصادقة API

> تقوم GOWA بمصادقة مكالمات API مع مصادقة HTTP الأساسية فقط.

يدعم GOWA **HTTP Basic Auth** ولا شيء آخر: لا توجد مفاتيح API أو رموز لحاملها أو JWT ل REST API. (MCP يمكن أن تقبل إضافة إلى ذلك رمز OAuth tokens؛ انظر [MCP server](https://gowa-docs.mintlify.site/ar/integrations/mcp.md#%D8%A7%D9%84%D8%B9%D9%85%D9%84%D8%A7%D8%A1-%D8%A7%D9%84%D8%A8%D8%B9%D9%8A%D8%AF%D9%8A%D9%86-%D9%85%D8%B9-oauth).)

## تكوين

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

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

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

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

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

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

| الطريق | لماذا |
| - | - |
| `/health` | التحقق من مدى الحياة. |
| `/statics/*` | صور QR وملفات الوسائط. عناوين URL المعروفة لا تزال عامة. تحميل غير الصورة كمرفقات. حماية الوصول إلى الوكيل الخاص بك إذا لزم الأمر. |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | مسموحة بواسطة Chatwot؛ مؤمن بواسطة `CHATWOOT_WEBHOOK_SECRET`. |
| نقاط نهاية MCP OAuth والبيانات الوصفية في `/.well-known/*` | تدفق OAuth عند التمكين. |

## 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`. انظر [تكوين الوصول إلى المتصفح](https://gowa-docs.mintlify.site/ar/authentication.md#cors).

## رأس الجهاز

المصادقة الأساسية تحدد متصل API، وليس حساب WhatsApp. كل مكالمة على نطاق الجهاز تحتاج أيضًا إلى `X-Device-Id` عندما يكون هناك أكثر من جهاز واحد. انظر [Multi-device](https://gowa-docs.mintlify.site/ar/concepts/multidevice.md).

> [!WARNING]
>
> ترسل المصادقة الأساسية بيانات الاعتماد على كل طلب. استخدم دائما HTTPS أمام GOWA خارج شبكة موثوق بها.


## Related topics

- [مرجع API](https://gowa-docs.mintlify.site/ar/api-reference/introduction.md)
- [المصادقة](https://gowa-docs.mintlify.site/ar/authentication.md)
- [مقاييس الخادم](https://gowa-docs.mintlify.site/ar/api-reference/metrics.md)
- [البداية السريعة](https://gowa-docs.mintlify.site/ar/quickstart.md)
- [GOWA: واجهة WhatsApp REST API](https://gowa-docs.mintlify.site/ar/index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.