> ## 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 وHTTP من واجهة كرزون.

تعيد أخطاء GraphQL حمولة قياسية `{ "errors": [...] }` مع `message` و`extensions.code`.

| الحالة       | الاستجابة المعتادة                    |
| ------------ | ------------------------------------- |
| رمز مفقود    | HTTP 401 أو خطأ مصادقة GraphQL        |
| رمز غير صالح | فشل المصادقة                          |
| خطأ تحقق     | `GRAPHQL_VALIDATION_FAILED`           |
| رفض الصلاحية | حقل أو عملية غير مسموحة لنطاق التطبيق |

<Tip>
  استخدم [الساحة داخل التطبيق](https://karzoun.chat/developer/playground) للتحقق من الاستعلامات وفحص حمولات الأخطاء.
</Tip>

## إصلاحات شائعة

* **401** — تحقق من ترويسة `x-app-token` وحالة التطبيق `isEnabled`
* **رفض الصلاحية** — قد لا تتضمن مجموعة مستخدمي التطبيق العملية؛ عدّل النطاقات في `/developer/apps`
* **التحقق** — يجب أن تطابق أسماء الحقول والوسائط [مرجع المخطط](/api-reference)


## Related topics

- [كيف يعمل](/ar/mcp-server/guides/how-it-works.md)
- [استكشاف الأخطاء](/ar/mcp-server/guides/troubleshooting.md)
- [الاخطاء الشائعة عند ربط قناة جديدة](/ar/help-center/guides/channels/doc-1890471.md)
- [مكالمات واتساب](/ar/help-center/guides/whatsapp/whatsapp-calling.md)