مرجع المطورين
التسجيل الدفاعي
باستخدام DomScan API، احمِ علامتك التجارية من خلال تحديد متغيرات النطاق التي يجب تسجيلها بشكل دفاعي. يحلل مخاطر انتحال الأخطاء المطبعية ونطاقات المستوى الأعلى الشائعة وينشئ قائمة تسجيل مرتبة حسب الأولوية.
التسجيل الدفاعي
احمِ علامتك التجارية من خلال تحديد متغيرات النطاق التي يجب تسجيلها بشكل دفاعي. يحلل مخاطر انتحال الأخطاء المطبعية ونطاقات المستوى الأعلى الشائعة وينشئ قائمة تسجيل مرتبة حسب الأولوية.
GET
/v1/recipes/defensive-registration
معاملات الاستعلام
| المعامل | النوع | مطلوب |
|---|---|---|
| brand | string | مطلوب |
| owned_domains | string | مطلوب |
| priority_tlds | string | اختياري |
| include_typos |
boolean
الافتراضي
true
|
اختياري |
| budget | number | اختياري |
حقول الرد
| الحقل | النوع |
|---|---|
success |
boolean |
data |
object |
data.brand |
string |
data.summary |
object |
data.summary.total_candidates |
number |
data.summary.already_owned |
number |
data.summary.available |
number |
data.summary.registered_by_others |
number |
data.summary.within_budget |
number |
data.priority_registrations[] |
object[] |
data.priority_registrations[] |
object |
data.priority_registrations[].domain |
string |
data.priority_registrations[].type |
string |
data.priority_registrations[].available |
boolean |
data.priority_registrations[].risk_if_unowned |
string |
data.priority_registrations[].price |
number |
data.priority_registrations[].registrar |
string |
data.typo_threats[] |
object[] |
data.typo_threats[] |
object |
data.typo_threats[].domain |
string |
data.typo_threats[].type |
string |
data.typo_threats[].available |
boolean |
data.typo_threats[].risk_if_unowned |
string |
data.typo_threats[].price |
null |
data.typo_threats[].registrar |
null |
data.shopping_cart |
object |
data.shopping_cart.domains[] |
string[] |
data.shopping_cart.total_cost |
number |
data.shopping_cart.within_budget |
boolean |
meta |
object |
meta.recipe_name |
string |
meta.credits_used |
number |
meta.credits_saved |
number |
meta.duration_ms |
number |
meta.components_called[] |
string[] |
meta.cached_components[] |
string[] |
meta.timestamp |
string |
errors[] |
array |
طلب مثال
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/defensive-registration?brand=acme&owned_domains=acme.com&priority_tlds=example.com&include_typos=true&budget=example.com"
مثال الرد
{
"success": true,
"data": {
"brand": "acme",
"summary": {
"total_candidates": 18,
"already_owned": 3,
"available": 9,
"registered_by_others": 6,
"within_budget": 5
},
"priority_registrations": [
{
"domain": "acme.io",
"type": "tld_variant",
"available": true,
"risk_if_unowned": "high",
"price": 39.99,
"registrar": "porkbun"
}
],
"typo_threats": [
{
"domain": "acm3.com",
"type": "typo",
"available": false,
"risk_if_unowned": "high",
"price": null,
"registrar": null
}
],
"shopping_cart": {
"domains": [
"acme.io",
"acme.co"
],
"total_cost": 63.98,
"within_budget": true
}
},
"meta": {
"recipe_name": "defensive-registration",
"credits_used": 12,
"credits_saved": 8,
"duration_ms": 688,
"components_called": [
"typosquatting",
"availability",
"pricing",
"tld-intelligence"
],
"cached_components": [
"pricing"
],
"timestamp": "2026-04-15T11:16:00Z"
},
"errors": []
}