Utvecklarreferens

E-postblocklista

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

E-postblocklista

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

GET /v1/email/check

Frågeparametrar

Parameter	Typ	Description
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

Kontrollera	Description	Riskpoäng
`disposable`	Kontrollerar mot en databas med över 80 000 engångsdomäner	+80
`role`	Detects role-based addresses (admin@, support@, etc.)	+20
`free`	Identifierar kostnadsfria e-postleverantörer (gmail, yahoo med flera)	+10
`mx`	Validerar att MX-poster finns för domänen	+50 (om inga finns)
`dnsbl`	Kontrollerar 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.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
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	string
`risk_score`	integer
`risk_level`	string
`flags[]`	string[]
`checked_at`	string

POST /v1/email/check/bulk

Begärandekropp

Parameter	Typ	Description
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

Parameter	Typ	Description
limit valfri	number	Antal domäner som ska returneras (standard: 1000, max: 10000)
offset valfri	number	Pagineringens offset (standard: 0)
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
`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

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"

Exempelsvar

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