TIL UDVIKLERE

API til e-mailverificering.

Brug tjek af enkeltadresser til formularer eller asynkrone opgaver til kundelister. Behold din nuværende e-mailudbyder.

START MED ÉN ADRESSE

Din første forespørgsel.

Brug det gratis demo-endpoint uden nøgle. Det har begrænset antal forespørgsler og er beregnet til at afprøve tjenesten.

curl -X POST https://api.zbounce.net/v1/demo \
  -H 'Content-Type: application/json' \
  -d '{"email":"hello@example.com"}'

Til betalte tjek skal du købe en pakke og bruge /v1/fast-verify med din nøgle i X-API-Key. Hold nøgler ude af URL'er, versionsstyring og analyseværktøjer.

curl -X POST https://api.zbounce.net/v1/fast-verify \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $ZBOUNCE_API_KEY" \
  -d '{"email":"hello@example.com"}'

Python-eksempel

import os, requests

response = requests.post(
    "https://api.zbounce.net/v1/fast-verify",
    headers={"X-API-Key": os.environ["ZBOUNCE_API_KEY"]},
    json={"email": "hello@example.com"},
    timeout=35,
)
response.raise_for_status()
print(response.json())

Node.js-eksempel

const response = await fetch("https://api.zbounce.net/v1/fast-verify", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.ZBOUNCE_API_KEY,
  },
  body: JSON.stringify({ email: "hello@example.com" }),
  signal: AbortSignal.timeout(35000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

EN LISTE IND, RESULTATER UD

Verificér en større liste.

POST /v1/tasks

Indsend op til 10.000 adresser pr. opgave. Gem det returnerede opgave-ID, og tjek accepted, skipped og invalids: ikke alle input sættes nødvendigvis i kø. Dubletter, forkert formaterede og spærrede adresser kan blive fjernet, og en lav saldo kan betyde, at listen kun delvist accepteres.

curl -X POST https://api.zbounce.net/v1/tasks \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $ZBOUNCE_API_KEY" \
  -d '{"emails":["hello@example.com","contact@example.org"]}'

Følg status, og hent derefter hver resultatside. Et svar, der kun indeholder ugyldige input, kan have et tomt opgave-ID; spørg ikke efter status på det.

curl "https://api.zbounce.net/v1/tasks/$TASK_ID" \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

curl "https://api.zbounce.net/v1/tasks-results/$TASK_ID?page=1&per_page=100" \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

Resultater af afsluttede opgaver er i JSON. Bliv ved med at hente sider, indtil hele den accepterede liste er hentet. Vil du have automatisk besked ved afslutning, kan du angive en webhook med mode: "completed" når du opretter opgaven.

{
  "emails": ["hello@example.com"],
  "webhook": {
    "url": "https://your-app.example/hooks/verification",
    "mode": "completed",
    "secret": "YOUR_PRIVATE_WEBHOOK_SECRET"
  }
}

Se skemaet for webhook-konfiguration og verificering af signaturer, før du aktiverer det i produktion.

FORSTÅ SVARET

Format er ikke det samme som eksistens.

Det er separate signaler. En korrekt formateret adresse kan stadig være ikke-eksisterende, en engangsadresse eller umulig at bekræfte.

Felt	Betydning
`valid`	Adressen bestod syntakskontrollen. Det alene bekræfter ikke postkassen.
`exists`	Resultatet af kontrollen af postkassen. Fortolk det sammen med fejl og catch-all-signaler.
`disposable`	Domænet blev genkendt som en udbyder af midlertidige e-mailadresser.
`accept_all`	Serveren accepterer vilkårlige adresser; den konkrete postkasse kan ikke bekræftes pålideligt.
`error_category`	Forklarer en fejl eller risiko, f.eks. no_mx, risky eller et midlertidigt serverproblem.
`permanent_error`	Der blev returneret en permanent fejl under tjekket. En midlertidig fejl bør ikke behandles som en permanent afvisning.
`ttl`	Et tidsforslag i sekunder til nyt forsøg/cache, når det returneres.

Verificering kan ikke garantere levering, forhindre klager eller bevise, hvem der ejer en postkasse.

Kend din saldo.

GET /v1/me

curl https://api.zbounce.net/v1/me \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

Svaret indeholder resterende, reserverede og brugte kreditter, nøgletype og udløbsdato. En standardverificering bruger én kredit; den faktiske filtrering og debitering afhænger af endpointet og af, om opgaven accepteres. Tjek svaret, før du betragter en hel uploadet liste som behandlet.

Et 429-svar betyder, at forespørgslerne begrænses. Vent, før du prøver igen. Andre fejl kan returneres som JSON eller tekst i det nuværende API; fortolk ikke HTTP-fejl som verificeringsresultater.

Verificeringskontrakten.

Download OpenAPI JSON

Den offentlige kontrakt dækker demo, hurtig verificering, opgaver, opgavestatus, resultater og kontosaldo. Endpoints til levering og administration ligger uden for denne verificeringsreference.

Brug for hjælp til at forbinde din platform? support@zbounce.net