Utvecklarreferens

E-postblocklista

Utforska API-dokumentationen för E-postblocklista, anropsparametrar, svarsfält, kodexempel och felhantering för DomScan-integrationer.

E-postblocklista

API för e-postvalidering som upptäcker engångs- eller tillfälliga e-postadresser, rollbaserade adresser och kostnadsfria leverantörer samt kontrollerar domänens anseende. Databasen innehåller över 80 000 engångsdomäner med konfidensnivåerna hög, medel och låg. Användbart för att förebygga registreringsbedrägerier och filtrera potentiella kunder efter kvalitet.

GET /v1/email/check

Frågeparametrar

ParameterTypDescription
email obligatorisk string Email address to check (e.g., "[email protected]")
checks valfri string Kommaseparerade kontroller att köra: disposable, role, free, mx, dnsbl. Standard: alla

Tillgängliga kontroller

KontrolleraDescriptionRiskpoäng
disposableKontrollerar mot en databas med över 80 000 engångsdomäner+80
roleDetects role-based addresses (admin@, support@, etc.)+20
freeIdentifierar kostnadsfria e-postleverantörer (gmail, yahoo med flera)+10
mxValiderar att MX-poster finns för domänen+50 (om inga finns)
dnsblKontrollerar domänen mot DNS-blocklistor (Spamhaus med flera)+15-60

Risknivåer

  • Låg (0–39):: Säker att acceptera
  • Medel (40–69):: Granskning rekommenderas
  • Hög (70–100):: Troligen bedräglig eller tillfällig

Exempelbegäran

# Full check (all validations)
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected]"

# Quick disposable check only
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected]&checks=disposable"
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/email/check",
    params={"email": "[email protected]"}
)
data = response.json()

if data['risk_level'] == 'high':
    print(f"Reject: {data['flags']}")
elif data['checks']['disposable']['is_disposable']:
    print("Disposable email detected")

Exempelsvar

{
  "email": "[email protected]",
  "domain": "tempmail.com",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": null
    },
    "free": {
      "is_free": false,
      "provider": null
    },
    "mx": {
      "has_mx": true,
      "records": ["mx.tempmail.com"]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": ["DISPOSABLE_DOMAIN"],
  "checked_at": "2025-01-15T12:00:00Z"
}

Svarsfält

Fält Typ
email string
domain string
local_part string
valid_syntax boolean
checks object
checks.disposable object
checks.disposable.is_disposable boolean
checks.disposable.confidence string | null
checks.disposable.matched_pattern string
checks.role object
checks.role.is_role boolean
checks.role.role_type string | null
checks.free object
checks.free.is_free boolean
checks.free.provider string | null
checks.mx object
checks.mx.has_mx boolean | null
checks.mx.records[] string[]
checks.mx.null_mx boolean
checks.dnsbl object
checks.dnsbl.domain string
checks.dnsbl.ip string
checks.dnsbl.listed boolean
checks.dnsbl.lists[] object[]
checks.dnsbl.lists[] object
checks.dnsbl.lists[].name string
checks.dnsbl.lists[].listed boolean
checks.dnsbl.lists[].status string
checks.dnsbl.lists[].code string
checks.dnsbl.lists[].meaning string
checks.dnsbl.lists[].unknown_reason string
checks.dnsbl.lists_unknown integer
checks.dnsbl.threat_level string
checks.dnsbl.check_type string
checks.dnsbl.checked_at string
risk_score integer
risk_level string
flags[] string[]
checked_at string
POST /v1/email/check/bulk

Begärandekropp

ParameterTypDescription
emails obligatorisk string[] Array med e-postadresser att kontrollera (högst 100 per begäran)
checks valfri string[] Kontroller att köra: ["disposable", "role", "free", "mx", "dnsbl"]

Användningsområden

  • Rensa e-postlistor före marknadsföringskampanjer
  • Validera användarregistreringar i realtid
  • Bedöm potentiella kunder utifrån e-postkvalitet
  • Identifiera mönster av registreringsbedrägerier

Exempelbegäran

curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/check/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ],
    "checks": ["disposable", "role"]
  }'

Exempelsvar

{
  "results": [
    {
      "email": "[email protected]",
      "risk_level": "low",
      "risk_score": 10,
      "flags": ["FREE_PROVIDER"]
    },
    {
      "email": "[email protected]",
      "risk_level": "high",
      "risk_score": 80,
      "flags": ["DISPOSABLE_DOMAIN"]
    },
    {
      "email": "[email protected]",
      "risk_level": "medium",
      "risk_score": 20,
      "flags": ["ROLE_ADDRESS"]
    }
  ],
  "summary": {
    "total": 3,
    "disposable": 1,
    "role_based": 1,
    "free_provider": 1,
    "high_risk": 1,
    "medium_risk": 1,
    "low_risk": 1
  },
  "checked_at": "2025-01-15T12:00:00Z"
}

Svarsfält

Fält Typ
results[] object[]
results[] object
summary object
summary.total integer
summary.disposable integer
summary.role_based integer
summary.free_provider integer
summary.no_mx integer
summary.dnsbl_listed integer
summary.high_risk integer
summary.medium_risk integer
summary.low_risk integer
checked_at string
GET /v1/email/blacklist

Frågeparametrar

ParameterTypDescription
limit valfri number Antal domäner som ska returneras (standard: 1000, max: 10000)
offset valfri number Pagineringens offset (standard: 0)
cursor valfri string next_cursor från föregående sida. Se paginering.
format valfri string json (standard) eller txt för en oformaterad textlista

Description

Ladda ner vår blocklista över engångsdomäner. Kostnadsfri för alla användare. Använd /v1/email/blacklist/download för hela listan som en nedladdningsbar fil.

Exempelbegäran

# Get first 1000 domains as JSON
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist"

# Get as plain text for firewall rules
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist?format=txt&limit=5000"

# Download complete blacklist
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist/download" -o disposable.json

Exempelsvar

{
  "domains": [
    "tempmail.com",
    "guerrillamail.com",
    "10minutemail.com",
    "mailinator.com",
    "..."
  ],
  "total": 85432,
  "offset": 0,
  "limit": 1000,
  "metadata": {
    "last_updated": "2025-01-15T00:00:00Z",
    "total_domains": 85432,
    "high_confidence_count": 12500,
    "wildcard_count": 234,
    "sources": [
      "disposable-email-domains",
      "ivolo/disposable-email-domains"
    ]
  }
}

Svarsfält

Fält Typ
has_more boolean
next_cursor string | null
domains[] string[]
total integer
offset integer
limit integer
metadata object
metadata.last_updated string
metadata.total_domains integer
metadata.high_confidence_count integer
metadata.wildcard_count integer
metadata.sources[] string[]
metadata.source_count integer
metadata.successful_source_count integer
metadata.failed_source_count integer
metadata.refresh_cadence_hours integer
metadata.refresh_status string
metadata.next_refresh_due string
metadata.dataset_status string
metadata.quality_policy_version integer | null
metadata.quarantined_domain_count integer
metadata.rejected_domain_count integer
GET /v1/email/blacklist/download Krediter: 0

Frågeparametrar

Parameter Typ obligatorisk
format string
Tillåtna värden jsontxt
Standard json
valfri

Svarsfält

Fält Typ
domains[] string[]
wildcards[] string[]
metadata object

Exempelbegäran

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=json"
const response = await fetch("https://domscan.net/v1/email/blacklist/download?format=json", {
  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/email/blacklist/download?format=json",
    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/email/blacklist/download?format=json", 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/email/blacklist/download?format=json")
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))

Exempelsvar

{
  "domains": [
    "example.com",
    "example.org"
  ],
  "wildcards": [
    "example"
  ],
  "metadata": {}
}

HTTP-statuskoder

  • 200 OK
  • 401 Obehörig
  • 429 För många begäranden