مرجع المطورين

سمعة النطاق

استكشف توثيق API الخاص بـ سمعة النطاق، بما في ذلك معلمات الطلب وحقول الاستجابة وأمثلة الشفرة ومعالجة الأخطاء لتكاملات DomScan.

سمعة النطاق

احصل على درجة سمعة شاملة (0-100) لأي نطاق بناءً على إشارات أمان وثقة متعددة. يفحص API تكوين أمان DNS والشهادات SSL والقوائم السوداء (Spamhaus و SURBL) وتحديد التهديدات (URLhaus) والمصادقة عبر البريد الإلكتروني والحضور عبر الويب لحساب درجة موزونة مع توصيات قابلة للتنفيذ.

GET /v1/reputation

معاملات الاستعلام

المعامل	النوع	مطلوب
domain	string	مطلوب

حقول الرد

الحقل	النوع
`domain`	string
`reputation_score`	integer
`grade`	string
`risk_level`	string
`reputation_score_confidence`	string
`grade_capped_by_parking`	boolean
`factors`	object
`factors.age`	object
`factors.dns_security`	object
`factors.ssl_certificate`	object
`factors.hosting`	object
`factors.web_presence`	object
`factors.blacklists`	object
`factors.email_config`	object
`recommendations[]`	object[]
`recommendations[]`	object
`recommendations[].priority`	string
`recommendations[].category`	string
`recommendations[].action`	string
`recommendations[].impact`	string
`evidence_summary`	object
`evidence_summary.checks_performed`	integer
`evidence_summary.cache_status`	string
`evidence_summary.confidence`	string
`evidence_summary.risk_level`	string
`evidence_summary.factor_count`	integer
`evidence_summary.scored_factor_count`	integer
`evidence_summary.passing_factor_count`	integer
`evidence_summary.warning_factor_count`	integer
`evidence_summary.failing_factor_count`	integer
`evidence_summary.lowest_scoring_factors[]`	object[]
`evidence_summary.lowest_scoring_factors[]`	object
`evidence_summary.lowest_scoring_factors[].name`	string
`evidence_summary.lowest_scoring_factors[].score`	number \| null
`evidence_summary.lowest_scoring_factors[].weight`	number \| null
`evidence_summary.blacklist_listed_count`	integer
`evidence_summary.recommendation_count`	integer
`evidence_summary.high_priority_recommendation_count`	integer
`evidence_summary.grade_capped_by_parking`	boolean
`meta`	object
`meta.query_time_ms`	integer
`meta.checks_performed`	integer
`meta.cached`	boolean
`meta.served_by`	string

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reputation?domain=example.com"

مثال الرد

{
  "domain": "example.com",
  "reputation_score": 76,
  "grade": "C",
  "risk_level": "medium",
  "reputation_score_confidence": "high",
  "grade_capped_by_parking": true,
  "factors": {
    "age": {
      "score": 84,
      "weight": 0.1,
      "details": {
        "age_days": 5840
      }
    },
    "dns_security": {
      "score": 80,
      "weight": 0.2,
      "details": {
        "dnssec": false,
        "spf": true,
        "dmarc": true,
        "dmarc_policy": "reject"
      }
    },
    "ssl_certificate": {
      "score": 92,
      "weight": 0.2,
      "details": {
        "valid": true,
        "error": null,
        "grade": "A",
        "chain_valid": true,
        "min_tls_version": "TLSv1.3"
      }
    },
    "hosting": {
      "score": 35,
      "weight": 0.1,
      "details": {
        "has_a_records": true,
        "a_record_count": 2,
        "parked": true
      }
    },
    "web_presence": {
      "score": 20,
      "weight": 0.15,
      "details": {
        "has_website": true,
        "redirects_to_https": true,
        "response_time_ms": 87,
        "parked": true,
        "for_sale": false,
        "parking_provider": "Example Parking"
      }
    },
    "blacklists": {
      "score": 100,
      "weight": 0.1,
      "details": {
        "listed": false,
        "threat_level": "none",
        "domain_sources": [],
        "ip_sources": []
      }
    },
    "email_config": {
      "score": 100,
      "weight": 0.15,
      "details": {
        "has_mx": true,
        "has_spf": true,
        "has_dmarc": true,
        "mx_count": 2
      }
    }
  },
  "recommendations": [
    {
      "priority": "high",
      "category": "web_presence",
      "action": "Move the domain off parking if it is intended for customer traffic.",
      "impact": "+10 points"
    }
  ],
  "meta": {
    "query_time_ms": 187,
    "checks_performed": 7,
    "cached": false,
    "served_by": "pop=MAD country=ES"
  }
}

POST /v1/reputation/bulk

نص الطلب

الحقل	النوع	Description
domains مطلوب	string[]	مصفوفة من أسماء المجالات الكاملة للفحص

استخدم POST /v1/reputation/bulk لتقييم عدة نطاقات في طلب واحد. أرسل جسم JSON يحتوي على مصفوفة domains. يدعم حتى 3 نطاقات لكل طلب لأن كل عملية فحص تتشعب إلى عدة تحققات أمنية.

طلب مثال

curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/reputation/bulk"   -H "Content-Type: application/json"   -d '{
    "domains": ["stripe.com", "cloudflare.com", "example.com"]
  }'

مثال الرد

{
  "results": [
    {
      "domain": "stripe.com",
      "reputation_score": 92,
      "grade": "A+",
      "risk_level": "low",
      "factors": {
        "dns_security": { "score": 100, "weight": 0.2 },
        "ssl_certificate": { "score": 100, "weight": 0.2 }
      },
      "recommendations": [],
      "meta": {
        "query_time_ms": 1250,
        "checks_performed": 7,
        "cached": false
      }
    },
    {
      "domain": "not a domain",
      "error": {
        "code": "INVALID_DOMAIN",
        "message": "Invalid domain format"
      }
    }
  ],
  "summary": {
    "total": 2,
    "successful": 1,
    "failed": 1,
    "cached": 0,
    "query_time_ms": 1310
  },
  "meta": {
    "served_by": "pop=MAD country=ES"
  }
}

حقول الرد

الحقل	النوع
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].reputation_score`	integer
`results[].grade`	string
`results[].risk_level`	string
`results[].reputation_score_confidence`	string
`results[].grade_capped_by_parking`	boolean
`results[].factors`	object
`results[].evidence_summary`	object
`results[].evidence_summary.checks_performed`	integer
`results[].evidence_summary.cache_status`	string
`results[].evidence_summary.confidence`	string
`results[].evidence_summary.risk_level`	string
`results[].evidence_summary.factor_count`	integer
`results[].evidence_summary.scored_factor_count`	integer
`results[].evidence_summary.passing_factor_count`	integer
`results[].evidence_summary.warning_factor_count`	integer
`results[].evidence_summary.failing_factor_count`	integer
`results[].evidence_summary.lowest_scoring_factors[]`	object[]
`results[].evidence_summary.lowest_scoring_factors[]`	object
`results[].evidence_summary.lowest_scoring_factors[].name`	string
`results[].evidence_summary.lowest_scoring_factors[].score`	number \| null
`results[].evidence_summary.lowest_scoring_factors[].weight`	number \| null
`results[].evidence_summary.blacklist_listed_count`	integer
`results[].evidence_summary.recommendation_count`	integer
`results[].evidence_summary.high_priority_recommendation_count`	integer
`results[].evidence_summary.grade_capped_by_parking`	boolean
`results[].recommendations[]`	object[]
`results[].recommendations[]`	object
`results[].meta`	object
`results[].error`	object
`results[].error.code`	string
`results[].error.message`	string
`summary`	object
`summary.total`	integer
`summary.successful`	integer
`summary.failed`	integer
`summary.cached`	integer
`summary.query_time_ms`	integer
`meta`	object
`meta.served_by`	string