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

# المصادقة

> ترويسة واحدة، ونوعان من بيانات الاعتماد.

```
Authorization: your-api-key
```

<Warning>
  لا تستخدم البادئة `Bearer`. يُرسل المفتاح كما هو دون أي بادئة. إضافة `Bearer `
  تؤدي إلى إرجاع `401`، وهذا هو الخطأ الأكثر شيوعًا على الإطلاق في الاستدعاء
  الأول.
</Warning>

## نوعان من بيانات الاعتماد، وترويسة واحدة

**مفتاح API** — من *Settings → Developers* (الإعدادات ← المطوِّرون). نطاقه
مقصور على المنظمة التي أنشأته. وهذا ما تحتاج إليه لبناء تكاملك الخاص.

**رمز وصول OAuth** — يُصدر لتطبيق معتمد كي يتمكن أشخاص آخرون من ربط حساباتهم
*هم* في نُشر بمنتجك. يُميَّز بالبادئة `pos_`، ويُستدل منه على المنظمة التي
منحت الوصول.

كلاهما يوضع في الترويسة نفسها؛ ويميّز الخادم بينهما من خلال البادئة.

## النطاق

يتصرف المفتاح باسم المنظمة بأكملها. لا توجد أذونات لكل مفتاح على حدة —
فالمفتاح القادر على القراءة قادر أيضًا على النشر وحذف المنشورات وفصل القنوات.

## الحفاظ على أمانه

<Warning>
  للاستخدام من جانب الخادم فقط. المفتاح الموجود في تعليمات المتصفح البرمجية
  يصبح علنيًا لحظة شحن الحزمة، ويمكنه فصل كل قناة في الحساب.
</Warning>

احتفظ به في متغير بيئة أو في مدير أسرار. وإذا تسرّب أحد المفاتيح، فألغِه من
*Settings → Developers* — يسري الإلغاء فورًا.

## التحقق من صلاحية المفتاح

```bash theme={null}
curl -i https://platform.nushir.com/api/public/v1/is-connected \
  -H "Authorization: $NUSHIR_API_KEY"
```

تعني `200` أن المفتاح صالح. وتعني `401` أنه مفقود، أو خاطئ، أو مسبوق ببادئة.


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