Geliştirici Referansı

Savunma Amaçlı Kayıt

Savunma Amaçlı Kayıt API belgelerini, istek parametrelerini, yanıt alanlarını, kod örneklerini ve DomScan entegrasyonları için hata işlemeyi inceleyin.

Savunma Amaçlı Kayıt

Hangi alan adı varyasyonlarını savunma amaçlı kaydetmeniz gerektiğini belirleyerek markanızı koruyun. Yazım hatası saldırıları risklerini ve yaygın TLD'leri analiz eder, öncelikli bir kayıt listesi oluşturur.

GET /v1/recipes/defensive-registration

Sorgu Parametreleri

Parametre	Tür	gerekli
brand	string	gerekli
owned_domains	string	gerekli
priority_tlds	string	isteğe bağlı
include_typos	boolean Varsayılan `true`	isteğe bağlı
budget	number	isteğe bağlı

Yanıt Alanları

Alan	Tür
`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

Örnek İstek

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"

Örnek Yanıt

{
  "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": []
}