Référence Développeur

Workflow d'audit préalable

API DomScan : Analyse complète d'acquisition de domaine avec données RDAP, évaluation, vérifications de santé et informations de protection de marque.

Workflow d'audit préalable

Analyse complète d'acquisition de domaine avec données RDAP, évaluation, vérifications de santé et informations de protection de marque.

GET /v1/recipes/due-diligence

Paramètres de Requête

Paramètre	Type	Description
domain requis	string	Domaine à analyser

La réponse inclut

Données d'enregistrement RDAP (bureau d'enregistrement, dates, serveurs de noms)
Estimation de la valeur du domaine
Résultats des vérifications de santé
Analyse de la réputation
Comparaison des prix entre bureaux d'enregistrement

Champs de Réponse

Champ	Type
`success`	boolean
`data`	object
`data.domain`	string
`data.summary`	object
`data.summary.recommendation`	string
`data.summary.confidence_score`	number
`data.summary.key_findings[]`	string[]
`data.summary.risk_factors[]`	string[]
`data.registration`	object
`data.registration.registrar`	string
`data.registration.created_date`	string
`data.registration.expiry_date`	string
`data.registration.updated_date`	string
`data.registration.age_years`	number
`data.registration.days_until_expiry`	number
`data.registration.status[]`	string[]
`data.registration.nameservers[]`	string[]
`data.registration.dnssec`	boolean
`data.registration.privacy_protected`	boolean
`data.valuation`	object
`data.valuation.estimate_low`	number
`data.valuation.estimate_mid`	number
`data.valuation.estimate_high`	number
`data.valuation.currency`	string
`data.valuation.confidence`	number
`data.valuation.factors`	object
`data.valuation.factors.length`	number
`data.valuation.factors.tld`	string
`data.valuation.factors.brandability`	number
`data.health`	object
`data.health.score`	number
`data.health.grade`	string
`data.health.dns_configured`	boolean
`data.health.ssl_valid`	boolean
`data.health.email_deliverable`	boolean
`data.health.warnings[]`	string[]
`data.security`	object
`data.security.reputation_score`	number
`data.security.reputation_grade`	string
`data.security.risk_level`	string
`data.security.blacklisted`	boolean
`data.security.blacklist_details[]`	array
`data.brand_protection`	object
`data.brand_protection.typo_score`	number
`data.brand_protection.typo_grade`	string
`data.brand_protection.variants_registered`	number
`data.brand_protection.high_risk_variants`	number
`data.pricing`	object
`data.pricing.best_price`	number
`data.pricing.best_registrar`	string
`data.pricing.all_prices[]`	object[]
`data.pricing.all_prices[]`	object
`data.pricing.all_prices[].registrar`	string
`data.pricing.all_prices[].price`	number
`data.pricing.all_prices[].currency`	string
`data.action_items[]`	object[]
`data.action_items[]`	object
`data.action_items[].priority`	string
`data.action_items[].category`	string
`data.action_items[].action`	string
`data.action_items[].details`	string
`data.action_items[].estimated_impact`	string
`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

Exemple de Réponse

{
  "success": true,
  "data": {
    "domain": "example.com",
    "summary": {
      "recommendation": "buy",
      "confidence_score": 88,
      "key_findings": [
        "Established registration history",
        "Clean reputation"
      ],
      "risk_factors": [
        "DNSSEC not enabled"
      ]
    },
    "registration": {
      "registrar": "Example Registrar",
      "created_date": "2019-03-11",
      "expiry_date": "2027-03-11",
      "updated_date": "2026-03-10",
      "age_years": 7,
      "days_until_expiry": 330,
      "status": [
        "active",
        "clientTransferProhibited"
      ],
      "nameservers": [
        "ns1.example.net",
        "ns2.example.net"
      ],
      "dnssec": false,
      "privacy_protected": true
    },
    "valuation": {
      "estimate_low": 1800,
      "estimate_mid": 3500,
      "estimate_high": 5200,
      "currency": "USD",
      "confidence": 0.72,
      "factors": {
        "length": 11,
        "tld": "com",
        "brandability": 0.81
      }
    },
    "health": {
      "score": 84,
      "grade": "A",
      "dns_configured": true,
      "ssl_valid": true,
      "email_deliverable": true,
      "warnings": [
        "DNSSEC not enabled"
      ]
    },
    "security": {
      "reputation_score": 91,
      "reputation_grade": "A",
      "risk_level": "low",
      "blacklisted": false,
      "blacklist_details": []
    },
    "brand_protection": {
      "typo_score": 78,
      "typo_grade": "B",
      "variants_registered": 2,
      "high_risk_variants": 1
    },
    "pricing": {
      "best_price": 9.99,
      "best_registrar": "cloudflare",
      "all_prices": [
        {
          "registrar": "cloudflare",
          "price": 9.99,
          "currency": "USD"
        }
      ]
    },
    "action_items": [
      {
        "priority": "medium",
        "category": "security",
        "action": "Enable DNSSEC",
        "details": "Improve zone integrity for resolvers.",
        "estimated_impact": "Lower spoofing risk"
      }
    ]
  },
  "meta": {
    "recipe_name": "domain-due-diligence",
    "credits_used": 12,
    "credits_saved": 6,
    "duration_ms": 742,
    "components_called": [
      "availability",
      "whois",
      "valuation",
      "health",
      "reputation",
      "typosquatting",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T09:30:00Z"
  },
  "errors": []
}