النطاقات المخصصة
افتراضياً تُقدَّم المستندات من رابط المشاركة الخاص بـPowerduck. يُظهر النطاق المخصص التوثيق وMCP تحت اسم مضيفك الخاص بدل رابط المشاركة، مهم لنشر الواجهة مع العلامة.
ميزة مدفوعة، متاحة في خطط Pro وTeam (تتحقق عبر إذن oas.custom_domain).
ربط مضيف كامل مقابل مسار فرعي
يشير الربط إلى:
- مضيف كامل —
api.example.comيقدّم مستنداً من الجذر. - مضيف ومسار فرعي —
example.com/v1يقدّم مستنداً تحت/v1.
ربط المسار الفرعي يتيح لمضيف واحد تقديم عدة مستندات.
example.com/v1 -> document A
example.com/v2 -> document B
هكذا يتجنّب حدّ مضيف واحد لكل مستند ويدعم مسارات أساسية مُنسَّخة.
المسارات من النطاق المخصص
تُقدَّم الأوضاع نفسها المتاحة على رابط المشاركة تحت مسارات قصيرة وثابتة على النطاق المربوط.
| الوضع | مضيف كامل | مسار فرعي |
|---|---|---|
| المواصفة الحالية | /oas | /v1/oas |
| مواصفة مثبَّتة على نسخة | /v/:version/oas | /v1/v/:version/oas |
| MCP | /mcp | /v1/mcp |
يحلّ المضيف إلى المستند المربوط عبر اسم مضيف الطلب والمسار. هذه المسارات تدير فحوص CORS.
إضافة نطاق والتحقق منه
لا يُوثَق بالنطاق قبل التحقق من الملكية، لذا التدفّق واضح.
- إضافة اسم المضيف (أو اسم المضيف والمسار) إلى المستند.
- يُرجِع الخدمة الربط وتعليمات DNS.
- أنشئ سجل DNS وتحقّق.
- ينتقل الربط من معلَّق إلى متحقَّق ويبدأ التقديم.
تأكيد الملكية يستخدم سجل TXT.
| الحقل | القيمة |
|---|---|
| نوع السجل | TXT |
| المضيف | _powerduck-challenge.<your-domain> |
| القيمة | powerduck-verify=<verification-token> |
تقرأ عملية التحقق سجل TXT من DNS وتقارن الرمز في زمن ثابت. الربط المتحقَّق يبقى متحقَّقاً دون إعادة كشف.
مثال
لـapi.example.com، أنشئ سجل TXT.
_powerduck-challenge.api.example.com
TXT "powerduck-verify=<the-token-shown-for-the-binding>"
ثم اختر تحقّق في مساحة المستند. متى ما عُلِّم متحقَّقاً، يُقدَّم التوثيق وMCP من ذلك النطاق (مستند نشط، أوضاع نشطة).
إدارة الروابط
- عرض النطاقات المربوطة بالمستند، مع الحالة والمسار الأساسي.
- تحقّق ربط معلَّق بعد سجل DNS.
- حذف ربط للتوقف عن التقديم من ذلك النطاق.
تغيير مؤشرات الوصول يُبطِل ذاكرة حلّ المضيف، كي تسري التحديثات فوراً ولا تُقدَّم روابط قديمة.
ضوابط الوصول تبقى مطبَّقة
النطاق المخصص ليس مساراً للالتفاف: تبقى نفس البوابات.
- المستند يجب أن يكون
ACTIVE. - لكل وضع مؤشّره النشط.
- كلمة مرور العرض تبقى تحمي التوثيق ومفتاح الوصول يحمي MCP.
انظر التحكم بالوصول.
انظر أيضاً: المستندات والنسخ、الفوترة.