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
| 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.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
| 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) |
| 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
200OK401Obehörig429För många begäranden