لماذا أحصل على 401 عند استدعاء API؟
تعرّف على الأسباب التي تجعل واجهة API في عليا بوكس ترفض طلباً بوصفه غير مصرح به.
تعني الاستجابة 401 UNAUTHORIZED أن عليا بوكس لم تتمكن من قبول مفتاح API في الطلب. يذكر الحقل message في نص الاستجابة السبب الدقيق؛ قارنه بالقائمة أدناه.
تحقق من الرسالة
| الرسالة | السبب | الحل |
|---|---|---|
| Send your API key in the X-API-KEY header | لا يوجد مفتاح في الطلب | أضف الترويسة X-API-KEY: sk_live_…. تعمل أيضاً Authorization: Bearer sk_live_…. |
| Malformed API key | القيمة ليست مفتاح عليا بوكس | تبدو المفاتيح كالتالي: sk_live_ أو sk_test_ متبوعة بـ 48 حرفاً سداسياً عشرياً. تحقق من عدم وجود أحرف مفقودة أو علامات اقتباس أو مسافات. |
| Unknown API key | المفتاح غير موجود | ربما نسخته بشكل خاطئ، أو أنه يخص بيئة أو مؤسسة أخرى في عليا بوكس. أنشئ مفتاحاً جديداً. |
| This API key was revoked | نقر أحدهم Revoke (إبطال) | أنشئ مفتاحاً جديداً ضمن API access (الوصول إلى API). |
| This API key has expired | انقضى تاريخ الانتهاء المحدد عند الإنشاء | أنشئ مفتاحاً جديداً بتاريخ انتهاء لاحق أو دون تاريخ انتهاء. |
خطوة بخطوة
- انتقل إلى API access (الوصول إلى API) ← API keys (مفاتيح API) واعثر على المفتاح ببادئته. يعرض عمود الحالة active أو expired أو revoked، ويخبرك Last used (آخر استخدام) ما إذا كان أي استدعاء به قد وصل من قبل.
- افتح علامة التبويب Recent requests (الطلبات الأخيرة). إذا لم يكن استدعاؤك مدرجاً، فإن الطلب لم يصل إلى عليا بوكس بمفتاح يمكن التعرف عليه: تحقق من عنوان URL الأساسي المعروض في بطاقة Endpoint (نقطة النهاية).
- شغّل المثال القابل للنسخ من بطاقة Endpoint باستخدام مفتاحك:
curl <base>/me -H "X-API-KEY: sk_live_…"
تؤكد الاستجابة 200 مع بيانات مؤسستك صحة المفتاح؛ وإذا استمر فشل التكامل، فالمشكلة في طريقة إرساله للترويسة.
ليست 401؟
- تعني
403 FORBIDDENأن المفتاح يعمل لكنه يفتقر إلى نطاق، أو أنX-Organization-Idيشير إلى مؤسسة لا تديرها شركة المحاسبة (CA firm) الخاصة بك. - الاستجابة
401في مربع حوار عمليات تسليم webhook هي الاتجاه المعاكس: رفض خادمك التسليم من عليا بوكس. ت حقق من آلية التحقق من التوقيع لديك.
معلومات مفيدة
- تُعرض المفاتيح مرة واحدة فقط عند إنشائها. تحتفظ عليا بوكس بتجزئة (hash) ولا يمكنها عرض المفتاح مرة أخرى.
- يمكن للمالكين والمسؤولين، أو الأعضاء الذين يملكون صلاحية "manage API keys" (إدارة مفاتيح API)، عرض المفاتيح وإنشاؤها.