استكشاف أخطاء المصادقة ومفاتيح API
تمر كل طلبات Orbit عبر بوابات متتالية: التحقق من بيانات الاعتماد، وانتهاء المفتاح وإلغائه، ومطابقة وضع الاختبار أو الإنتاج، وقائمة عناوين IP، ثم الصلاحيات. اقرأcode في الاستجابة لأن عدة بوابات قد تستخدم رمز HTTP نفسه.
أخطاء 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 وبادئة المفتاح فقط.