Référence Développeur

Recette de vérification préalable Documentation de l'API

Recette de vérification préalable Documentation de l'API: Analyse complète d'acquisition de domaine avec données RDAP, évaluation, vérifications de santé et informations de protection de marque.

Recette de vérification 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 (registraire, 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 auprès des registraires

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": 10,
    "credits_saved": 8,
    "duration_ms": 742,
    "components_called": [
      "availability",
      "whois",
      "valuation",
      "health",
      "reputation",
      "typosquatting",
      "pricing"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T09:30:00Z"
  },
  "errors": []
}