Bezpieczeństwo i zaufanie · Produkt DomScan

API Reputacja domeny

Sprawdź reputację domeny na podstawie wielu źródeł wywiadu zagrożeń.

Co otrzymasz

Sprawdź reputację domeny na podstawie wielu źródeł wywiadu zagrożeń.

SynchronicznyRESTMCPSDKNarzędzie interaktywne

Wybierz ten produkt, gdy

Dla kogo jest ten produkt

Używaj ograniczonych kontroli pasywnych do wzbogacania triage i badań, a nie zamiast autoryzowanych testów lub analizy człowieka.

Wybierz ten produkt, gdy

Wybierz dla połączonego obrazu reputacji z widocznymi dowodami, pokryciem i wynikami nieznanymi.

Co otrzymasz

Sprawdź reputację domeny na podstawie wielu źródeł wywiadu zagrożeń.

Endpointy

Zobacz, co każdy endpoint przyjmuje i zwraca, jakie ma tryby i limity, zanim zaczniesz integrację.

GET /v1/reputation Otwórz referencję API

Kredyty i uwierzytelnianie

3 Wymagane uwierzytelnianie. Dokładny koszt, w tym ewentualne ceny za element, znajdziesz w dokumentacji API.

Przykładowa operacja

Korzystaj z udokumentowanych operacji, aby zbierać, oceniać, wzbogacać, weryfikować, porównywać, chronić lub monitorować publiczne dane.

GET /v1/reputation Kredyty: 3

Parametry zapytania

Parametr Typ wymagane
domain string wymagane

Pola odpowiedzi

Pole Typ
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

Przykładowe żądanie

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))

Przykładowa odpowiedź

{
  "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"
  }
}

Kody statusu HTTP

  • 200 OK
  • 400 Nieprawidłowe żądanie
  • 401 Nieautoryzowany
  • 402 Wymagana płatność
  • 429 Zbyt wiele żądań

Często zadawane pytania

Gdzie znajdę referencję żądań i odpowiedzi dla Reputacja domeny?

W referencji API dla Reputacja domeny znajdziesz parametry, pola odpowiedzi, przykłady, kody stanu i obsługiwane tryby wykonania.

Jak interpretować nieznane lub niepełne wyniki Reputacja domeny?

Wynik nieznany lub częściowy oznacza, że nie udało się go w pełni potwierdzić. Uwzględnij status, pewność, aktualność i wszelkie limity, zanim na jego podstawie zadziałasz.

Jak wyceniany jest Reputacja domeny?

Cena zależy od sprawdzenia i wybranego trybu. Dokumentacja API pokazuje aktualny koszt w kredytach, informację, czy potrzebujesz klucza API, oraz ewentualne ceny za element.

Używany przez ludzi w tych firmach

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse