Statuscodes

De Enrow API gebruikt standaard HTTP-statuscodes om de uitkomst van elk verzoek aan te geven, plus een qualification-veld dat je het resultaat van een zoekopdracht of verificatie vertelt. Deze pagina vermeldt elke code en kwalificatiewaarde, zodat je responsen betrouwbaar kunt afhandelen. Voor de bijbehorende foutmeldingen en responsformaten, zie Foutafhandeling.

​

Welke HTTP-statuscodes retourneert de API?

De Enrow API gebruikt standaard HTTP-statuscodes om het resultaat van elk verzoek aan te geven. Een 2xx-code betekent dat het verzoek is geslaagd, een 4xx-code wijst op een probleem met het verzoek, en een 5xx-code betekent dat er iets is misgegaan aan de kant van Enrow.

​

Welke codes betekenen succes?

Een 2xx-statuscode betekent dat de API het verzoek heeft geaccepteerd. Asynchrone bewerkingen (zoals bulkzoekopdrachten) retourneren 201 of 202 omdat het werk op de achtergrond doorloopt.

​

Welke codes betekenen dat het verzoek is geweigerd?

Een 4xx-statuscode betekent dat de API het verzoek heeft geweigerd vanwege iets dat aan de clientzijde kan worden opgelost — ongeldige parameters, een ontbrekende of ongeldige API-sleutel, onvoldoende credits, of te veel verzoeken. Een 401 betekent dat de API-sleutel ontbreekt of ongeldig is — zie Authenticatie voor hoe je deze correct meegeeft. Een 402 betekent dat het account geen credits meer heeft; bekijk het verbruik in Credits en facturatie. Een 429 betekent dat het verzoek de toegestane doorvoer heeft overschreden — zie Rate limits om de drempelwaarden te begrijpen.

​

Welke codes betekenen een serverfout?

Een 5xx-statuscode betekent dat het verzoek geldig was, maar dat er iets is misgegaan aan de kant van Enrow. Deze responsen kun je veilig opnieuw proberen na een korte vertraging.

​

Wat zijn zoekkwalificaties?

Een zoekkwalificatie is de waarde in het qualification-veld die je de uitkomst van een zoekopdracht of verificatie vertelt. Enrow retourneert dit veld in alle endpoints, en het resultaat is altijd binair — er is geen “misschien” of waarschijnlijkheidsscore. Dit is een bewuste ontwerpkeuze.

​

Waarom is het resultaat binair?

Het resultaat is binair omdat een duidelijk ja-of-nee-antwoord makkelijker te gebruiken is dan een waarschijnlijkheid. De meeste verrijkingstools retourneren een complexe reeks categorieën — catch-all, riskant, onbekend, onverifieerbaar, enz. — die je dwingen om logica rond waarschijnlijkheden op te bouwen. Enrow heeft de tegenovergestelde aanpak gekozen:

• Enrow verifieert zelfs catch-all-e-mails deterministisch, dus er is geen behoefte aan een “catch-all”-categorie
• Enrow gelooft niet in probabilistische systemen met tientallen classificaties — ze voegen complexiteit toe zonder duidelijkheid
• Een binair resultaat betekent dat je direct op de gegevens kunt handelen zonder te twijfelen

Het resultaat is ofwel goed, ofwel niet. Eenvoudig.

​

Welke kwalificaties retourneert Email Finder?

De Email Finder retourneert een van de volgende waarden in het qualification-veld:

​

Welke kwalificaties retourneert Email Verifier?

De Email Verifier retourneert een van de volgende waarden in het qualification-veld:

​

Welke kwalificaties retourneert Phone Finder?

De Phone Finder retourneert een van de volgende waarden in het qualification-veld:

​

Hoe volg ik een bulkzoekopdracht?

Voor bulkbewerkingen geeft een status-veld de voortgang van de batch aan. Poll het relevante GET-endpoint — Email Finder bulkresultaten, Email Verifier bulkverificaties, of Phone Finder bulkresultaten — totdat de status op completed staat.

​

FAQ

​

Volgende stappen