ابدأ مجانًا →

رموز الأخطاء

مفاتيح 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 للشخص أو بريده الإلكتروني) بمفتاح خدمة مأذون له بتسمية الأشخاص.
من يستطيع فعله
مطوّر الشيفرة المستدعية · افتح الشاشة

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.
من يستطيع فعله
مالك أو مسؤول في مساحة العمل · افتح الشاشة

invalid_key_identity

ما يعنيه
المفتاح الشخصي يتحدث دائمًا باسم مالكه: لا يمكنه أن يسمّي أشخاصًا آخرين أيضًا.
السبب الأكثر شيوعًا
مفتاح شخصي أُنشئ مع تفعيل خيار تسمية الأشخاص.
ما يجب فعله
لتسمية الأشخاص، أنشئ مفتاح خدمة بهذا الخيار؛ أما المفتاح الشخصي فيُنشأ من دونه.
من يستطيع فعله
مالك أو مسؤول في مساحة العمل · افتح الشاشة