# لماذا أحصل على 401 عند استدعاء API؟

> تعرّف على الأسباب التي تجعل واجهة API في عليا بوكس ترفض طلباً بوصفه غير مصرح به.

Source: /help/ar/api/401-troubleshooting

تعني الاستجابة `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 | انقضى تاريخ الانتهاء المحدد عند الإنشاء | أنشئ مفتاحاً جديداً بتاريخ انتهاء لاحق أو دون تاريخ انتهاء. |

## خطوة بخطوة

1. انتقل إلى **API access** (الوصول إلى API) ← **API keys** (مفاتيح API) واعثر على المفتاح ببادئته. يعرض عمود الحالة active أو expired أو revoked، ويخبرك **Last used** (آخر استخدام) ما إذا كان أي استدعاء به قد وصل من قبل.
2. افتح علامة التبويب **Recent requests** (الطلبات الأخيرة). إذا لم يكن استدعاؤك مدرجاً، فإن الطلب لم يصل إلى عليا بوكس بمفتاح يمكن التعرف عليه: تحقق من عنوان URL الأساسي المعروض في بطاقة **Endpoint** (نقطة النهاية).
3. شغّل المثال القابل للنسخ من بطاقة 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)، عرض المفاتيح وإنشاؤها.

## مقالات ذات صلة

- [بيئات API ومفاتيحها](/help/ar/api/environments-and-api-keys)
- [أخطاء API ورموز الحالة](/help/ar/api/error-handling)