Spring til hovedindhold
Enrow API’et bruger standard HTTP-statuskoder til at angive udfaldet af hver anmodning samt et qualification-felt, der fortæller dig resultatet af en søgning eller verificering. Denne side oplister alle koder og kvalifikationsværdier, så du kan håndtere svar pålideligt. For de tilhørende fejlbeskeder og svarformater, se Fejlhåndtering.

Hvilke HTTP-statuskoder returnerer API’et?

Enrow API’et bruger standard HTTP-statuskoder til at angive resultatet af hver anmodning. En 2xx-kode betyder, at anmodningen lykkedes, en 4xx-kode peger på et problem med anmodningen, og en 5xx-kode betyder, at noget gik galt hos Enrow.

Hvilke koder betyder succes?

En 2xx-statuskode betyder, at API’et accepterede anmodningen. Asynkrone operationer (såsom masse-søgninger) returnerer 201 eller 202, fordi arbejdet fortsætter i baggrunden.
CodeMeaningDescription
200OKAnmodning lykkedes, resultater returneret
201CreatedRessource oprettet (f.eks. masse-søgning igangsat)
202AcceptedAnmodning accepteret, behandles asynkront

Hvilke koder betyder, at anmodningen blev afvist?

En 4xx-statuskode betyder, at API’et afviste anmodningen på grund af noget, der kan rettes på klientsiden — ugyldige parametre, en manglende eller ugyldig API-nøgle, utilstrækkelige credits eller for mange anmodninger.
CodeMeaningDescription
400Bad RequestUgyldige eller manglende parametre
401UnauthorizedUgyldig eller manglende API-nøgle
402Payment RequiredUtilstrækkelige credits
429Too Many RequestsHastighedsgrænse overskredet
En 401 betyder, at API-nøglen mangler eller er ugyldig — se Autentificering for, hvordan du sender den korrekt. En 402 betyder, at kontoen er løbet tør for credits; gennemgå forbruget i Credits og fakturering. En 429 betyder, at anmodningen overskred den tilladte gennemstrømning — se Hastighedsgrænser for at forstå tærsklerne.
API’et returnerer aldrig 404. Et ukendt eller udløbet søgnings-ID returnerer 400 for masse-endpoints og 500 for enkelt-endpoints.

Hvilke koder betyder en serverfejl?

En 5xx-statuskode betyder, at anmodningen var gyldig, men at noget gik galt hos Enrow. Disse svar er sikre at prøve igen efter en kort forsinkelse.
CodeMeaningDescription
500Internal Server ErrorNoget gik galt hos os

Hvad er søgningskvalifikationer?

En søgningskvalifikation er værdien i qualification-feltet, der fortæller dig udfaldet af en søgning eller verificering. Enrow returnerer dette felt på tværs af alle endpoints, og resultatet er altid binært — der er intet “måske” eller sandsynlighedsscore. Dette er et bevidst designvalg.

Hvorfor er resultatet binært?

Resultatet er binært, fordi et klart ja-eller-nej-svar er lettere at handle på end en sandsynlighed. De fleste berigelsesværktøjer returnerer et komplekst sæt af kategorier — catch-all, risky, unknown, unverifiable osv. — der tvinger dig til at bygge logik omkring sandsynligheder. Enrow valgte den modsatte tilgang:
  • Enrow verificerer selv catch-all-emails deterministisk, så der er ikke behov for en “catch-all”-kategori
  • Enrow tror ikke på probabilistiske systemer med snesevis af klassifikationer — de tilføjer kompleksitet uden klarhed
  • Et binært resultat betyder, at du kan handle på dataene med det samme uden at tvivle
Resultatet er enten godt, eller også er det ikke. Enkelt.

Hvilke kvalifikationer returnerer Email Finder?

Email Finder returnerer en af følgende værdier i qualification-feltet:
QualificationMeaning
validEmail fundet og verificeret
invalidEmail ikke fundet
ongoingSøgning stadig i gang

Hvilke kvalifikationer returnerer Email Verifier?

Email Verifier returnerer en af følgende værdier i qualification-feltet:
QualificationMeaning
validEmail er gyldig og leveringsbar
invalidEmail er ugyldig eller ikke leveringsbar
ongoingVerificering stadig i gang
invalid betyder forskellige ting afhængigt af endpointet: på Email Finder betyder det, at emailen ikke blev fundet. På Email Verifier betyder det, at emailen eksisterer, men ikke er leveringsbar.

Hvilke kvalifikationer returnerer Phone Finder?

Phone Finder returnerer en af følgende værdier i qualification-feltet:
QualificationMeaning
foundTelefonnummer fundet med succes
not_foundTelefonnummer kunne ikke findes
ongoingSøgning stadig i gang

Hvordan sporer jeg en masse-søgning?

For masse-operationer angiver et status-felt batchets fremdrift. Poll det relevante GET-endpoint — Email Finder masse-resultater, Email Verifier masse-verificeringer eller Phone Finder masse-resultater — indtil status er completed.
StatusMeaning
ongoingBatch behandles stadig
completedAlle søgninger i batchet er færdige
failedBatchet fejlede

FAQ

En 401 Unauthorized betyder, at API-nøglen mangler eller er ugyldig. Sørg for, at hver anmodning indeholder en gyldig nøgle i x-api-key-headeren. Se Autentificering for detaljer.
En 402 Payment Required betyder, at kontoen ikke har nok credits til at gennemføre anmodningen. Fyld op eller gennemgå, hvordan credits forbruges pr. endpoint i Credits og fakturering.
Enrow API’et returnerer aldrig 404. Et ukendt eller udløbet søgnings-ID returnerer 400 for masse-endpoints og 500 for enkelt-endpoints. Dobbelttjek det id, der blev returneret, da søgningen blev igangsat.
Nej. ongoing betyder, at søgningen eller verificeringen stadig er i gang. Poll GET-endpointet igen efter en kort forsinkelse, eller brug en webhook for automatisk at blive underrettet, når den er færdig — se Sådan fungerer webhooks.

Næste skridt

Fejlhåndtering

Se de fulde fejlbeskeder og svarformater for hver statuskode.

Autentificering

Send din API-nøgle i x-api-key-headeren for at undgå 401-fejl.

Hastighedsgrænser

Forstå tærsklerne, der udløser et 429-svar.

Credits og fakturering

Se, hvordan credits forbruges, og undgå 402-fejl.