Beveiliging & vertrouwen · DomScan-product

Domeinreputatie API-referentie

Controleer domeinreputatie op meerdere bedreigingsinformatiebronnen.

Wat je krijgt

Controleer domeinreputatie op meerdere bedreigingsinformatiebronnen.

SynchroonRESTMCPSDKInteractieve tool

Kies dit product wanneer

Voor wie is dit?

Gebruik begrensde passieve controles om triage en onderzoek te verrijken, niet om geautoriseerde tests of menselijke beoordeling te vervangen.

Kies dit product wanneer

Kies dit voor een gecombineerd reputatiebeeld met zichtbaar bewijs, dekking en onbekende resultaten.

Wat je krijgt

Controleer domeinreputatie op meerdere bedreigingsinformatiebronnen.

Endpoints

Bekijk vóór de integratie wat elk endpoint accepteert en teruggeeft, plus de modi en limieten.

GET /v1/reputation API-referentie bekijken

Credits en authenticatie

3 Authenticatie vereist. Zie de API-referentie voor de exacte kosten, inclusief eventuele prijzen per item.

Voorbeeldbewerking

Gebruik gedocumenteerde bewerkingen om openbaar bewijs te verzamelen, te beoordelen, te verrijken, te verifiëren, te vergelijken, te beschermen of te monitoren.

GET /v1/reputation Tegoeden: 3

Queryparameters

Parameter Type vereist
domain string vereist

Antwoordvelden

Veld Type
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

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reputation?domain=example.com"
const response = await fetch("https://domscan.net/v1/reputation?domain=example.com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/reputation?domain=example.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/reputation?domain=example.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/reputation?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Voorbeeldantwoord

{
  "domain": "example.com",
  "reputation_score": 69,
  "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"
  }
}

HTTP-statuscodes

  • 200 OK
  • 400 Ongeldig verzoek
  • 401 Niet geautoriseerd
  • 402 Betaling vereist
  • 429 Te veel verzoeken

Veelgestelde vragen

Waar vind ik de request- en response-referentie voor Domeinreputatie?

Gebruik de API-referentie voor Domeinreputatie om parameters, responsevelden, voorbeelden, statuscodes en ondersteunde uitvoeringsmodi te bekijken.

Hoe moet ik onbekende of onvolledige resultaten van Domeinreputatie interpreteren?

Onbekend of gedeeltelijk betekent dat we het resultaat niet volledig konden bevestigen. Houd rekening met de status, betrouwbaarheid, actualiteit en eventuele limieten wanneer u erop handelt.

Hoe wordt Domeinreputatie geprijsd?

De prijs hangt af van de controle en de modus die u kiest. De API-referentie toont de actuele kosten in credits, of u een API-sleutel nodig hebt en eventuele prijzen per item.

Gebruikt door mensen bij deze bedrijven

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse