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

# المصادقة

> رموز التطبيقات وترويسات الطلب لواجهة GraphQL العامة لكرزون.

تستخدم الواجهة العامة **رموز التطبيقات** (JWT) التي تُنشأ من لوحة مطوّري كرزون.

أرسل الرمز مع كل طلب:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
-H "x-app-token: YOUR_APP_TOKEN_JWT"
```

## تنسيق الطلب

كل طلب GraphQL هو POST بصيغة JSON مع الرمز في الترويسات.

### الترويسات المطلوبة

| الترويسة       | مطلوبة | الوصف                              |
| -------------- | ------ | ---------------------------------- |
| `x-app-token`  | نعم    | JWT التطبيق من المطوّر ← التطبيقات |
| `Content-Type` | نعم    | `application/json`                 |

### الصلاحيات

يمكن تقييد التطبيقات على مجموعات مستخدمين أو السماح بها لجميع المستخدمين. أنشئ التطبيقات بأقل صلاحيات تحتاجها تكاملاتك.

<CodeGroup>
  ```graphql theme={"theme":{"light":"github-light","dark":"github-dark"}}
  query {
    currentUser {
      _id
      email
    }
  }
  ```

  ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X POST 'https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql' \
    -H 'Content-Type: application/json' \
    -H 'x-app-token: YOUR_APP_TOKEN' \
    -d '{"query":"query { currentUser { _id email } }"}'
  ```
</CodeGroup>

<Tip>
  استخدم استعلام `currentUser` للتأكد من المصادقة قبل بناء التكاملات.
</Tip>

## الأمان

* لا تعرض رموز التطبيقات أبداً في الشيفرة على جانب المتصفح
* استخدم MCP والوكلاء من جانب الخادم مع الرموز على الخلفية فقط
* دوّر الرموز بإنشاء تطبيق جديد وإلغاء القديم

## الخطوات التالية

* [البداية السريعة](/ar/developers/getting-started/quickstart)
* [مرجع GraphQL API](/api-reference)


## Related topics

- [المصادقة](/ar/miniapps/guides/authentication.md)
- [استكشاف الأخطاء](/ar/miniapps/guides/troubleshooting.md)
- [أفضل الممارسات](/ar/miniapps/guides/best-practices.md)
- [MCP المستضاف (/mcp)](/ar/mcp-server/setup/hosted.md)
- [تعطيل المصادقة الثنائية](/ar/help-center/guides/whatsapp/doc-1914556.md)