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

# استكشاف أخطاء المصادقة ومفاتيح API

> حدد سبب رفض 401 أو 403 أو 422 وأصلح المفتاح أو وضع البيئة أو قائمة عناوين IP.

# استكشاف أخطاء المصادقة ومفاتيح API

تمر كل طلبات Orbit عبر بوابات متتالية: التحقق من بيانات الاعتماد، وانتهاء المفتاح وإلغائه، ومطابقة وضع الاختبار أو الإنتاج، وقائمة عناوين IP، ثم الصلاحيات. اقرأ `code` في الاستجابة لأن عدة بوابات قد تستخدم رمز HTTP نفسه.

| الرمز | HTTP | البوابة |
| - | - | - |
| `UNAUTHORIZED` | 401 | لا توجد بيانات اعتماد صالحة |
| `INVALID_API_KEY` | 401 | المفتاح غير معروف أو ملغى أو مصدره غير مسموح |
| `EXPIRED_TOKEN` | 401 | انتهت صلاحية المفتاح أو بدأ إلغاؤه المجدول |
| `WRONG_KEY_MODE` | 403 | وضع المفتاح لا يطابق مساحة العمل |
| `IP_NOT_ALLOWED` | 403 | قائمة IP الخاصة بالمؤسسة رفضت المصدر |
| `INSUFFICIENT_PERMISSIONS` | 403 | النطاق أو الدور لا يسمح بالمسار |
| محاولة كتابة بمفتاح عام | 422 | المفتاح `dv_..._pk_` للقراءة فقط |
| `STALE_WEBHOOK` | 401 | طابع webhook قديم أو مفقود |

## أخطاء 401

مع `UNAUTHORIZED` تأكد من إرسال الرأس `X-API-Key` وقيمة المفتاح كاملة. يشير `INVALID_API_KEY` إلى مفتاح غير صحيح أو ملغى أو إلى قائمة IP خاصة بالمفتاح. انسخ المفتاح من **Settings → API Keys**، وأنشئ بديلاً إذا فُقد السر. أما `EXPIRED_TOKEN` فيعني أن وقت الانتهاء أو `revoke_at` قد حان؛ دوّر المفتاح.

## وضع الاختبار والإنتاج

يجب أن يطابق `dv_test_sk_` مساحة العمل التجريبية وأن يطابق `dv_live_sk_` مساحة العمل الحية. يسبب الخلط `403 WRONG_KEY_MODE` قبل تشغيل أي معالج. أنشئ المفتاح في المؤسسة التي تستدعيها ولا تعِد استخدام مفتاح مؤسسة أخرى.

## قوائم عناوين IP

لقائمة المفتاح، يظهر المصدر غير المسموح كـ `401 INVALID_API_KEY` عمداً. أما قائمة المؤسسة فتظهر كـ `403 IP_NOT_ALLOWED`. تحقق من عنوان NAT العام الذي تراه الحافة، ثم أضفه أو نطاق CIDR إلى القائمة المناسبة من إعدادات الأمان.

## المفاتيح العامة و SAML/SCIM

المفاتيح العامة للقراءة فقط. استخدم مفتاحاً سرياً على خادمك لأي كتابة مثل `messages:write`، واحتفظ بأقل نطاقات القراءة في المفتاح العام. في المؤسسات، يجب أن ينتمي مستخدم SAML إلى المؤسسة، ويجب ألا يتجاوز دور SCIM سقف الدور الذي يملكه المستأجر.

لا ترسل المفتاح السري إلى الدعم. أرسل رمز الخطأ و`request_id` وبادئة المفتاح فقط.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.