رموز الأخطاء
مفاتيح API والشخص الذي يُجرى الاستدعاء لأجله
كل رمز من هذه الفئة: ما يعنيه، وسببه الأكثر شيوعًا، وما يجب فعله، ومن يستطيع فعله.
api_key_invalid
- ما يعنيه
- مفتاح Azoth API المرسل مع الاستدعاء لا يطابق أي مفتاح نشط.
- السبب الأكثر شيوعًا
- مفتاح ملغى أو منتهي الصلاحية، أو مفتاح نُسخ وينقصه حرف.
- ما يجب فعله
- مفتاح Azoth API هذا غير صالح (مُلغى أو منتهٍ أو منسوخ بشكل خاطئ). أنشئ مفتاحًا جديدًا في الإعدادات › الوصول.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
api_key_missing
- ما يعنيه
- لا يحمل الاستدعاء أي مفتاح Azoth API.
- السبب الأكثر شيوعًا
- الترويسة
AuthorizationأوX-Azoth-API-Keyمفقودة، وغالبًا لأن متغير بيئة غير معيَّن. - ما يجب فعله
- لم يُرسل أي مفتاح Azoth API. الصق مفتاحًا من الإعدادات › الوصول.
- من يستطيع فعله
- مطوّر الشيفرة المستدعية
api_key_scope_denied
- ما يعنيه
- المفتاح صالح، لكنه مقيّد — بنطاقات (أجزاء واجهة API التي يمكنه استدعاؤها) أو بموصلات أو ببيئات — وهذا الاستدعاء يقع خارج هذه الحدود. عند الإبلاغ عن الاستخدام، يحدد الحقل
dimensionفي الرد أيّ حدّ رفضه:connectorأوenvironment. - السبب الأكثر شيوعًا
- مفتاح أُنشئ لاستخدام واحد، كالإبلاغ عن الاستخدام أو القراءة، استدعى جزءًا آخر من واجهة API — أو أرسل أحداثًا لموصل أو بيئة لم يُنشأ المفتاح لهما.
- ما يجب فعله
- مفتاح API هذا مقيّد ببعض النطاقات أو الموصلات أو البيئات، وهذا الاستدعاء يقع خارجها. أنشئ مفتاحًا يشمله، أو مفتاحًا دون هذه القيود (غير مقيّد).
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
api_key_name_taken
- ما يعنيه
- يحمل مفتاح نشط في مساحة العمل الاسم المطلوب بالفعل: لا يتشارك مفتاحان نشطان في مساحة العمل نفسها اسمًا واحدًا.
- السبب الأكثر شيوعًا
- مفتاح أُنشئ سابقًا بهذا الاسم ولم يُلغَ قط — يحتفظ المفتاح المنتهي الصلاحية باسمه ما لم يُلغَ.
- ما يجب فعله
- يوجد في مساحة العمل هذه مفتاح نشط بهذا الاسم. اختر اسمًا آخر، أو ألغِ ذلك المفتاح أولًا في الإعدادات › الوصول.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
api_key_role_denied
- ما يعنيه
- المفتاح صالح، لكن دوره — قراءة أو كتابة أو إدارة — أدنى مما يتطلبه هذا المسار: لا يمكن لمفتاح قراءة استدعاء مسار يكتب، ويتطلب تصدير إعدادات مساحة العمل مفتاح إدارة.
- السبب الأكثر شيوعًا
- مفتاح أُنشئ للقراءة فقط، يستخدمه رمز يرسل بيانات أو يُجري تغييرات — أو مفتاح بدور غير الدور الذي أُعدّ له التكامل.
- ما يجب فعله
- دور مفتاح API هذا لا يسمح بهذا الاستدعاء: لا يمكن لمفتاح قراءة أن يكتب، وتتطلب بعض عمليات التصدير مفتاح إدارة. أنشئ مفتاحًا بالدور المطلوب في الإعدادات › الوصول.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
ip_not_allowed
- ما يعنيه
- المفتاح صالح، لكن الاستدعاء جاء من عنوان خارج قائمة عناوين IP المسموح بها في مساحة العمل: لا تقبل مساحة العمل مفاتيح API الخاصة بها إلا من العناوين التي تدرجها.
- السبب الأكثر شيوعًا
- خادم جديد أو دالة سحابية أو شبكة لم يُدرج عنوانها الصادر بعد — أو وكيل يغيّر العنوان الذي يأتي منه الاستدعاء.
- ما يجب فعله
- جاء هذا الاستدعاء من عنوان خارج قائمة عناوين IP المسموح بها في مساحة العمل. استدعِ من عنوان مُدرج، أو اطلب من مالك أو مسؤول إضافة هذا العنوان.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل
on_behalf_of_not_allowed
- ما يعنيه
- حُظر هذا الاستدعاء: لا يجوز لمفتاح الواجهة البرمجية الخاص به أن يسمّي الشخص الذي يُجرى لأجله.
- السبب الأكثر شيوعًا
- لا يرسل X-Azoth-On-Behalf-Of إلا مفتاح خدمة أذن له مالك أو مسؤول بذلك. أما المفتاح الشخصي فيتحدث دائمًا باسم صاحبه.
- ما يجب فعله
- أرسلوا الاستدعاء دون هذا الترويسة، أو اطلبوا من مالك أو مسؤول مفتاح خدمة مأذونًا له بتسمية الأشخاص (الإعدادات › الوصول).
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
human_identity_required
- ما يعنيه
- حُظر هذا الاستدعاء: لا يسمّي الشخص الذي يُجرى لأجله.
- السبب الأكثر شيوعًا
- تشترط مساحة العمل هذه أن يُنسب كل استدعاء إلى شخص، حتى يُظهر كل قرار من اتخذه.
- ما يجب فعله
- استخدموا مفتاحكم الشخصي، أو أرسلوا X-Azoth-On-Behalf-Of (معرّف SCIM للشخص أو بريده الإلكتروني) بمفتاح خدمة مأذون له بتسمية الأشخاص.
- من يستطيع فعله
- مطوّر الشيفرة المستدعية · افتح الشاشة
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.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة
invalid_key_identity
- ما يعنيه
- المفتاح الشخصي يتحدث دائمًا باسم مالكه: لا يمكنه أن يسمّي أشخاصًا آخرين أيضًا.
- السبب الأكثر شيوعًا
- مفتاح شخصي أُنشئ مع تفعيل خيار تسمية الأشخاص.
- ما يجب فعله
- لتسمية الأشخاص، أنشئ مفتاح خدمة بهذا الخيار؛ أما المفتاح الشخصي فيُنشأ من دونه.
- من يستطيع فعله
- مالك أو مسؤول في مساحة العمل · افتح الشاشة