API-dokument för validering av e-post

API-status

Komma igång

Alla API-förfrågningar kräver autentisering med hjälp av en API-nyckel. Du kan hitta din API-nyckel i instrumentpanelen.

Rubrik: "x-api-nyckel: din-api-nyckel"

Enkel verifiering

Verifiera en enskild e-postadress eller domän med avseende på giltighet, engångsstatus, integritetstjänster och leveransbarhet.

Slutpunkt

GET /v1/verify

Parametrar

NamnTypKrävsBeskrivning
inputstringJaE-postadress eller domän som ska verifieras (t.ex. [email protected] eller example.com)

apiDocs.responseFields

FältBeskrivning
validAnger om e-postformatet är korrekt
blockAnger om e-postmeddelandet ska blockeras (true om disposable, privacy, applePrivateEmail, deliverable eller catch_all är true)
disposableAvgör om e-postadressen är en tillfällig e-postadress eller en e-postadress för engångsbruk
privacyAvgör om e-postservern använder ett e-postalias eller en vidarebefordrare
applePrivateEmailAnger om e-postadressen är en Apple Private-e-postadress
deliverableKontrollerar om brevlådan finns och kan ta emot e-post
domainDomändelen av e-postadressen
email_addressE-postadressen
catch_allAnger om domänen har en e-postkonfiguration som accepterar alla inkommande e-postmeddelanden oavsett mottagaradress
mx_foundAnger om domänen har giltiga e-postservrar (MX-poster)
remaining_creditsAntalet API-krediter som finns kvar på ditt konto

Exempel på svar

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Exempel på kod

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Testa det

Du behöver en API-nyckel för att testa slutpunkterna.

Batchverifiering

Verifiera flera e-postadresser eller domäner i en enda begäran (max 100 objekt).

Slutpunkt

POST /v1/verify/batch

Parametrar

NamnTypKrävsBeskrivning
inputsarray of stringsJaArray av e-postadresser eller domäner som ska verifieras

Exempel på kod

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Testa det

Du behöver en API-nyckel för att testa slutpunkterna.

Prova med olika domäner: