curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
النطاقات المخصصة
إضافة نطاق مخصص
POST /custom-domain/
POST
/
custom-domain
/
curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
يربط نطاقًا مخصصًا جديدًا بالحساب، على مضيف Management API (
إضافة نطاق لا تتحقق منه —
api.scanova.io)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.
POST https://api.scanova.io/custom-domain/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
مطلوب
النطاق المراد توصيله، مثل
links.example.com. تُطبَّع بادئة المخطط والشرطة المائلة الختامية وحالة الأحرف تلقائيًا — أرسلها بأي صيغة تريدها.curl -X POST "https://api.scanova.io/custom-domain/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "domain": "links.example.com" }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": false,
"is_cname_verified": false,
"is_migrated": false,
"dns_provider": { "name": "Cloudflare", "placeholders": { "cname": { "content": { "label": "Target" } } } },
"txt_error": null,
"cname_error": null,
"root_action": "no_action",
"redirect": null,
"template": null,
"protocol": "https",
"remove_qr_query": false,
"cname_target": "shortcname.scanova.io",
"domain_connect_supported": false,
"domain_connect_checked_at": null,
"created": "2026-09-08T10:00:00Z",
"modified": "2026-09-08T10:00:00Z"
}
txt_value وcname_target في الاستجابة هما سجلا DNS اللذان لا يزال يتعين عليك (أو على مالك النطاق) إضافتهما، وتبدأ is_txt_verified/is_cname_verified بقيمة false. تتحقق Scanova بشكل غير متزامن، مباشرة بعد الإنشاء، مما إذا كان مسجِّل النطاق يدعم الإعداد بنقرة واحدة عبر Domain Connect؛ تعكس domain_connect_supported النتيجة بمجرد اكتمال هذا الفحص.
يُعاد 400 إذا كان النطاق غير صالح أو متصلًا بالفعل بأي حساب (فحص التفرد لا يميّز حالة الأحرف). يُعاد 403 إذا كان الحساب يفتقر إلى حصة CUSTOM_DOMAIN، أو كانت خطته غير مفعّلة، أو يفتقر إلى صلاحية CUSTOM_DOMAIN_CAN_ADD، أو بلغ الحد الأقصى لعدد النطاقات.
ذات صلة
- سرد النطاقات المخصصة — الاطلاع على النطاقات المتصلة.
- التحقق من سجلات DNS لنطاق مخصص — فحص السجلات بعد الإضافة.
- الحصول على رابط إعداد Domain Connect — إعداد DNS بنقرة واحدة، عند الدعم.
- إرسال إرشادات إعداد DNS بالبريد الإلكتروني — تفويض الخطوات اليدوية لجهة أخرى.
- نظرة عامة على Management API — مخطط المصادقة وقواعد الحصة المطبّقة على نقطة النهاية هذه.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
Domain added.
هل كانت هذه الصفحة مفيدة؟