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

# المصادقة

> صادق على طلبات Pubrio API باستخدام رأس `pubrio-api-key` — الإعداد، وإدارة المفاتيح، وأفضل ممارسات الأمان.

## مفتاح API

للمصادقة، يجب تضمين رأس `pubrio-api-key`. ينبغي أن يحتوي هذا الرأس على مفتاح API الخاص بك، على سبيل المثال `a1b2c3d4e5f6g7h8` الذي يمثل مفتاح API الخاص بك.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
```

يلزمك إنشاء مفتاح API للوصول إلى Pubrio API. يمكنك إنشاء مفتاح API من خلال الدخول إلى قسم [الإعدادات](https://dashboard.pubrio.com/#/settings/).

<Note>
  يتضمن مفتاح API بالفعل معلومات مساحة عملك (Profile)، لذا لا تحتاج إلى تمرير `profile_id` في نص الطلب. لا يزال معامل `profile_id` مقبولًا للحفاظ على التوافق مع الإصدارات السابقة، إلا أنه لم يعد مطلوبًا.
</Note>

## رؤوس الطلب

بجانب `pubrio-api-key`، أرسل رأس `User-Agent` لتحديد هوية العميل الخاص بك.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
Content-Type: application/json
User-Agent: my-app/1.0
```

<Warning>
  **يُرفض رأس `User-Agent` المفقود أو العام قبل وصول الطلب إلى API.** تُحظر الطلبات التي لا تحمل وكيل مستخدم (user agent) معروفًا عند الحافة (edge)، وتُعاد بالرمز `HTTP 403` مع نص عادي بمحتوى `error code: 1010` — وهو ليس بصيغة JSON، وليس من ضمن [رموز الأخطاء الموثقة](/ar/api-reference/status-codes). قد يبدو هذا وكأنه فشل في المصادقة، لكنه ليس كذلك: مفتاح API الخاص بك سليم.

  تتأثر وكلاء المستخدم الافتراضيون لمكتبات HTTP الشائعة — إذ يُحظر `urllib` الخاص بـ Python (`Python-urllib/3.x`)، بينما لا يُحظر كل من `curl` و`requests`. إذا واجهت `error code: 1010`، فحدّد رأس `User-Agent` صراحةً وأعد المحاولة.
</Warning>