# مفاتيح API والشخص الذي يُجرى الاستدعاء لأجله

كل رمز من هذه الفئة: ما يعنيه، وسببه الأكثر شيوعًا، وما يجب فعله، ومن يستطيع فعله.

[كل رموز الأخطاء](https://www.azothos.ai/ar/docs/errors)

### `api_key_invalid`

- **ما يعنيه**: مفتاح Azoth API المرسل مع الاستدعاء لا يطابق أي مفتاح نشط.
- **السبب الأكثر شيوعًا**: مفتاح ملغى أو منتهي الصلاحية، أو مفتاح نُسخ وينقصه حرف.
- **ما يجب فعله**: مفتاح Azoth API هذا غير صالح (مُلغى أو منتهٍ أو منسوخ بشكل خاطئ). أنشئ مفتاحًا جديدًا في الإعدادات › الوصول.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_missing`

- **ما يعنيه**: لا يحمل الاستدعاء أي مفتاح Azoth API.
- **السبب الأكثر شيوعًا**: الترويسة `Authorization` أو `X-Azoth-API-Key` مفقودة، وغالبًا لأن متغير بيئة غير معيَّن.
- **ما يجب فعله**: لم يُرسل أي مفتاح Azoth API. الصق مفتاحًا من الإعدادات › الوصول.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `api_key_scope_denied`

- **ما يعنيه**: المفتاح صالح، لكنه مقيّد — بنطاقات (أجزاء واجهة API التي يمكنه استدعاؤها) أو بموصلات أو ببيئات — وهذا الاستدعاء يقع خارج هذه الحدود. عند الإبلاغ عن الاستخدام، يحدد الحقل `dimension` في الرد أيّ حدّ رفضه: `connector` أو `environment`.
- **السبب الأكثر شيوعًا**: مفتاح أُنشئ لاستخدام واحد، كالإبلاغ عن الاستخدام أو القراءة، استدعى جزءًا آخر من واجهة API — أو أرسل أحداثًا لموصل أو بيئة لم يُنشأ المفتاح لهما.
- **ما يجب فعله**: مفتاح API هذا مقيّد ببعض النطاقات أو الموصلات أو البيئات، وهذا الاستدعاء يقع خارجها. أنشئ مفتاحًا يشمله، أو مفتاحًا دون هذه القيود (غير مقيّد).
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_name_taken`

- **ما يعنيه**: يحمل مفتاح نشط في مساحة العمل الاسم المطلوب بالفعل: لا يتشارك مفتاحان نشطان في مساحة العمل نفسها اسمًا واحدًا.
- **السبب الأكثر شيوعًا**: مفتاح أُنشئ سابقًا بهذا الاسم ولم يُلغَ قط — يحتفظ المفتاح المنتهي الصلاحية باسمه ما لم يُلغَ.
- **ما يجب فعله**: يوجد في مساحة العمل هذه مفتاح نشط بهذا الاسم. اختر اسمًا آخر، أو ألغِ ذلك المفتاح أولًا في الإعدادات › الوصول.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_role_denied`

- **ما يعنيه**: المفتاح صالح، لكن دوره — قراءة أو كتابة أو إدارة — أدنى مما يتطلبه هذا المسار: لا يمكن لمفتاح قراءة استدعاء مسار يكتب، ويتطلب تصدير إعدادات مساحة العمل مفتاح إدارة.
- **السبب الأكثر شيوعًا**: مفتاح أُنشئ للقراءة فقط، يستخدمه رمز يرسل بيانات أو يُجري تغييرات — أو مفتاح بدور غير الدور الذي أُعدّ له التكامل.
- **ما يجب فعله**: دور مفتاح API هذا لا يسمح بهذا الاستدعاء: لا يمكن لمفتاح قراءة أن يكتب، وتتطلب بعض عمليات التصدير مفتاح إدارة. أنشئ مفتاحًا بالدور المطلوب في الإعدادات › الوصول.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `ip_not_allowed`

- **ما يعنيه**: المفتاح صالح، لكن الاستدعاء جاء من عنوان خارج قائمة عناوين IP المسموح بها في مساحة العمل: لا تقبل مساحة العمل مفاتيح API الخاصة بها إلا من العناوين التي تدرجها.
- **السبب الأكثر شيوعًا**: خادم جديد أو دالة سحابية أو شبكة لم يُدرج عنوانها الصادر بعد — أو وكيل يغيّر العنوان الذي يأتي منه الاستدعاء.
- **ما يجب فعله**: جاء هذا الاستدعاء من عنوان خارج قائمة عناوين IP المسموح بها في مساحة العمل. استدعِ من عنوان مُدرج، أو اطلب من مالك أو مسؤول إضافة هذا العنوان.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل

### `on_behalf_of_not_allowed`

- **ما يعنيه**: حُظر هذا الاستدعاء: لا يجوز لمفتاح الواجهة البرمجية الخاص به أن يسمّي الشخص الذي يُجرى لأجله.
- **السبب الأكثر شيوعًا**: لا يرسل X-Azoth-On-Behalf-Of إلا مفتاح خدمة أذن له مالك أو مسؤول بذلك. أما المفتاح الشخصي فيتحدث دائمًا باسم صاحبه.
- **ما يجب فعله**: أرسلوا الاستدعاء دون هذا الترويسة، أو اطلبوا من مالك أو مسؤول مفتاح خدمة مأذونًا له بتسمية الأشخاص (الإعدادات › الوصول).
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `human_identity_required`

- **ما يعنيه**: حُظر هذا الاستدعاء: لا يسمّي الشخص الذي يُجرى لأجله.
- **السبب الأكثر شيوعًا**: تشترط مساحة العمل هذه أن يُنسب كل استدعاء إلى شخص، حتى يُظهر كل قرار من اتخذه.
- **ما يجب فعله**: استخدموا مفتاحكم الشخصي، أو أرسلوا X-Azoth-On-Behalf-Of (معرّف SCIM للشخص أو بريده الإلكتروني) بمفتاح خدمة مأذون له بتسمية الأشخاص.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)

### `identity_unavailable`

- **ما يعنيه**: حُظر هذا الاستدعاء: تعذّر التحقق من الشخص الذي يُجرى لأجله.
- **السبب الأكثر شيوعًا**: تعذّر على Azoth قراءة المفتاح أو قواعد النسبة في مساحة العمل، ولا يخدم استدعاءً لا يستطيع نسبته حين تكون النسبة مشترطة.
- **ما يجب فعله**: أعيدوا المحاولة بعد قليل.
- **من يستطيع فعله**: Azoth، أو مشغّل هذا النشر

### `invalid_on_behalf_of`

- **ما يعنيه**: ليست الترويسة `X-Azoth-On-Behalf-Of` معرّف شخص يستطيع Azoth قراءته.
- **السبب الأكثر شيوعًا**: الترويسة فارغة، أو تتجاوز 256 حرفًا، أو تحوي حروفًا خارج ASCII المرئي.
- **ما يجب فعله**: يجب أن يتكوّن X-Azoth-On-Behalf-Of من 1 إلى 256 حرفًا من حروف ASCII المرئية: أرسلوا معرّف SCIM للشخص أو بريده الإلكتروني.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `key_not_bound_to_agent`

- **ما يعنيه**: لا تجيب بوابة MCP إلا مفتاح API مرتبطًا بوكيل واحد — الوكيل الذي يحدد تفويضه ما يمكن للمفتاح استدعاؤه — وهذا المفتاح غير مرتبط بأي وكيل.
- **السبب الأكثر شيوعًا**: استُخدم مفتاح لمساحة العمل بدلًا من المفتاح المُنشأ لوكيل في علامة تبويب أدوات MCP، أو مفتاح وكيل فُكّ ارتباطه منذ ذلك الحين.
- **ما يجب فعله**: مفتاح API هذا غير مرتبط بأي وكيل. أنشئ مفتاحًا للوكيل في علامة تبويب أدوات MCP ضمن التفويضات، وأعطِ ذلك المفتاح لعميل MCP.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/mandats?tab=mcp)

### `invalid_key_identity`

- **ما يعنيه**: المفتاح الشخصي يتحدث دائمًا باسم مالكه: لا يمكنه أن يسمّي أشخاصًا آخرين أيضًا.
- **السبب الأكثر شيوعًا**: مفتاح شخصي أُنشئ مع تفعيل خيار تسمية الأشخاص.
- **ما يجب فعله**: لتسمية الأشخاص، أنشئ مفتاح خدمة بهذا الخيار؛ أما المفتاح الشخصي فيُنشأ من دونه.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=access)
