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

# واجهة Hybridbox البرمجية العامة

> استخدم واجهة Hybridbox البرمجية العامة لإدارة الحسابات والنطاقات وصناديق البريد وسجلات DNS وقواعد إعادة التوجيه وكلمات المرور الرئيسية والوسوم ومساحات العمل وعناوين IP المخصصة.

# واجهة Hybridbox البرمجية العامة

## المصادقة

تستخدم واجهة REST API رموز وصول bearer من OAuth 2.0.

للحصول على رمز في تكامل متصفح أو تطبيق ويب:

1. ابدأ تدفق OAuth القياسي برمز التفويض باستخدام العميل العام لتطبيق Hybridbox الويب.
2. أرسل المستخدم إلى نقطة تفويض Hybridbox واطلب نطاقات OpenID المعتادة.
3. بعد تسجيل دخول المستخدم، بدّل رمز التفويض المرجع برموز عبر نقطة الرموز في Hybridbox. يجب على عملاء المتصفح العامين استخدام PKCE؛ ويجب على تطبيقات الويب من جهة الخادم تنفيذ التبديل في الخلفية.
4. اقرأ `access_token` من استجابة الرموز.

استخدم رمز الوصول في طلبات REST API التي تتطلب المصادقة:

```http theme={null}
Authorization: Bearer <access_token>
```

تتحقق API من مصدر الرمز وتتطلب معرف عميل عام مسموحا، بما في ذلك عميل تطبيق Hybridbox الويب. تعرض صفحات نقاط النهاية أي أذونات إضافية مطلوبة للمستخدم أو المجموعة المصادق عليها.

## مواصفة OpenAPI

نزّل عقد واجهة API العامة الكامل بصيغة [openapi.json](/openapi.json).