curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"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"
}
النطاقات المخصصة
التحقق من سجلات DNS لنطاق مخصص
POST /custom-domain/verify/
POST
/
custom-domain
/
verify
/
curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"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"
}
يعيد فحص سجلات DNS لنطاق مخصص ويحدّث حالة التحقق الخاصة به، على مضيف Management API (
هذا ليس فحص حالة — بل يُجري بحث DNS فعليًا لسجلي TXT وCNAME مقابل النطاق في هذه اللحظة، ويحفظ ما يجده (بما في ذلك
api.scanova.io)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.
POST https://api.scanova.io/custom-domain/verify/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
يتطلب خطة مفعّلة.
integer
مطلوب
معرّف
id الخاص بالنطاق، من سرد النطاقات المخصصة.curl -X POST "https://api.scanova.io/custom-domain/verify/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "id": 42 }'
{
"id": 42,
"domain": "https://links.example.com",
"is_default": false,
"disable_slug_case": false,
"txt_value": "scanova-verification=abc123...",
"is_txt_verified": true,
"is_cname_verified": true,
"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_error/cname_error عند فشل أحد البحثين). توقع أن يستغرق هذا الاستدعاء لحظة، ولا تستطلعه بمعدل أسرع مما قد يبرره انتشار DNS. يُعاد 400 إذا لم يكن id نطاقًا مملوكًا لهذا الحساب.
ذات صلة
- سرد النطاقات المخصصة — الاطلاع على الأعلام المحدَّثة دون إعادة تشغيل التحقق.
- إضافة نطاق مخصص — من أين يأتي
txt_value/cname_target. - الحصول على رابط إعداد Domain Connect — مسار بديل للإعداد بنقرة واحدة يتحقق تلقائيًا عند الاكتمال.
- نظرة عامة على 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 with updated verification flags.
هل كانت هذه الصفحة مفيدة؟