qualification-Feld, das Ihnen das Ergebnis einer Suche oder Verifizierung mitteilt. Diese Seite listet jeden Code und jeden Qualifikationswert auf, damit Sie Antworten zuverlässig verarbeiten können. Die passenden Fehlermeldungen und Antwortformate finden Sie unter Fehlerbehandlung.
Welche HTTP-Statuscodes gibt die API zurück?
Die Enrow-API verwendet standardmäßige HTTP-Statuscodes, um das Ergebnis jeder Anfrage anzuzeigen. Ein2xx-Code bedeutet, dass die Anfrage erfolgreich war, ein 4xx-Code weist auf ein Problem mit der Anfrage hin, und ein 5xx-Code bedeutet, dass auf Seiten von Enrow etwas schiefgelaufen ist.
Welche Codes bedeuten Erfolg?
Ein2xx-Statuscode bedeutet, dass die API die Anfrage angenommen hat. Asynchrone Vorgänge (etwa Massensuchen) geben 201 oder 202 zurück, da die Verarbeitung im Hintergrund weiterläuft.
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Anfrage erfolgreich, Ergebnisse zurückgegeben |
| 201 | Created | Ressource erstellt (z. B. Massensuche gestartet) |
| 202 | Accepted | Anfrage angenommen, asynchrone Verarbeitung |
Welche Codes bedeuten, dass die Anfrage abgelehnt wurde?
Ein4xx-Statuscode bedeutet, dass die API die Anfrage aufgrund eines Problems abgelehnt hat, das auf der Client-Seite behoben werden kann – ungültige Parameter, ein fehlender oder ungültiger API-Schlüssel, unzureichende Credits oder zu viele Anfragen.
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 400 | Bad Request | Ungültige oder fehlende Parameter |
| 401 | Unauthorized | Ungültiger oder fehlender API-Schlüssel |
| 402 | Payment Required | Unzureichende Credits |
| 429 | Too Many Requests | Ratenlimit überschritten |
401 bedeutet, dass der API-Schlüssel fehlt oder ungültig ist – unter Authentifizierung erfahren Sie, wie Sie ihn korrekt übergeben. Ein 402 bedeutet, dass das Konto keine Credits mehr hat; prüfen Sie den Verbrauch unter Credits & Abrechnung. Ein 429 bedeutet, dass die Anfrage den zulässigen Durchsatz überschritten hat – unter Ratenlimits erfahren Sie mehr über die Schwellenwerte.
Die API gibt niemals 404 zurück. Eine unbekannte oder abgelaufene Such-ID liefert bei Massen-Endpunkten 400 und bei Einzel-Endpunkten 500.
Welche Codes bedeuten einen Serverfehler?
Ein5xx-Statuscode bedeutet, dass die Anfrage gültig war, aber auf Seiten von Enrow etwas schiefgelaufen ist. Diese Antworten können nach einer kurzen Verzögerung gefahrlos erneut versucht werden.
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 500 | Internal Server Error | Auf unserer Seite ist etwas schiefgelaufen |
Was sind Suchqualifikationen?
Eine Suchqualifikation ist der Wert imqualification-Feld, der Ihnen das Ergebnis einer Suche oder Verifizierung mitteilt. Enrow gibt dieses Feld über alle Endpunkte hinweg zurück, und das Ergebnis ist immer binär – es gibt kein „vielleicht“ und keinen Wahrscheinlichkeitswert. Dies ist eine bewusste Designentscheidung.
Warum ist das Ergebnis binär?
Das Ergebnis ist binär, weil eine klare Ja-oder-Nein-Antwort leichter umzusetzen ist als eine Wahrscheinlichkeit. Die meisten Anreicherungstools geben einen komplexen Satz von Kategorien zurück – catch-all, riskant, unbekannt, nicht verifizierbar usw. –, die Sie zwingen, Logik rund um Wahrscheinlichkeiten aufzubauen. Enrow hat den entgegengesetzten Ansatz gewählt:- Enrow verifiziert selbst Catch-all-E-Mails deterministisch, sodass keine „catch-all“-Kategorie nötig ist
- Enrow glaubt nicht an probabilistische Systeme mit Dutzenden von Klassifizierungen – sie schaffen Komplexität ohne Klarheit
- Ein binäres Ergebnis bedeutet, dass Sie sofort auf die Daten reagieren können, ohne sie zu hinterfragen
Welche Qualifikationen gibt der Email Finder zurück?
Der Email Finder gibt einen der folgenden Werte imqualification-Feld zurück:
| Qualifikation | Bedeutung |
|---|---|
valid | E-Mail gefunden und verifiziert |
invalid | E-Mail nicht gefunden |
ongoing | Suche noch in Bearbeitung |
Welche Qualifikationen gibt der Email Verifier zurück?
Der Email Verifier gibt einen der folgenden Werte imqualification-Feld zurück:
| Qualifikation | Bedeutung |
|---|---|
valid | E-Mail ist gültig und zustellbar |
invalid | E-Mail ist ungültig oder nicht zustellbar |
ongoing | Verifizierung noch in Bearbeitung |
invalid bedeutet je nach Endpunkt Unterschiedliches: Beim Email Finder bedeutet es, dass die E-Mail nicht gefunden wurde. Beim Email Verifier bedeutet es, dass die E-Mail existiert, aber nicht zustellbar ist.Welche Qualifikationen gibt der Phone Finder zurück?
Der Phone Finder gibt einen der folgenden Werte imqualification-Feld zurück:
| Qualifikation | Bedeutung |
|---|---|
found | Telefonnummer erfolgreich ermittelt |
not_found | Telefonnummer konnte nicht gefunden werden |
ongoing | Suche noch in Bearbeitung |
Wie verfolge ich eine Massensuche?
Bei Massenvorgängen zeigt einstatus-Feld den Fortschritt des Batches an. Fragen Sie den entsprechenden GET-Endpunkt ab – Massenergebnisse des Email Finders, Massenverifizierungen des Email Verifiers oder Massenergebnisse des Phone Finders –, bis der status auf completed steht.
| Status | Bedeutung |
|---|---|
ongoing | Batch wird noch verarbeitet |
completed | Alle Suchen im Batch sind abgeschlossen |
failed | Der Batch ist fehlgeschlagen |
FAQ
Warum erhalte ich ein 401 statt eines 200?
Warum erhalte ich ein 401 statt eines 200?
Ein
401 Unauthorized bedeutet, dass der API-Schlüssel fehlt oder ungültig ist. Stellen Sie sicher, dass jede Anfrage einen gültigen Schlüssel im x-api-key-Header enthält. Weitere Informationen finden Sie unter Authentifizierung.Was bedeutet ein 402-Statuscode?
Was bedeutet ein 402-Statuscode?
Ein
402 Payment Required bedeutet, dass das Konto nicht genügend Credits hat, um die Anfrage abzuschließen. Laden Sie Ihr Guthaben auf oder prüfen Sie unter Credits & Abrechnung, wie Credits pro Endpunkt verbraucht werden.Warum gibt eine unbekannte Such-ID 400 oder 500 statt 404 zurück?
Warum gibt eine unbekannte Such-ID 400 oder 500 statt 404 zurück?
Die Enrow-API gibt niemals
404 zurück. Eine unbekannte oder abgelaufene Such-ID liefert bei Massen-Endpunkten 400 und bei Einzel-Endpunkten 500. Überprüfen Sie die id, die beim Start der Suche zurückgegeben wurde.Bedeutet qualification: ongoing, dass etwas fehlgeschlagen ist?
Bedeutet qualification: ongoing, dass etwas fehlgeschlagen ist?
Nein.
ongoing bedeutet, dass die Suche oder Verifizierung noch in Bearbeitung ist. Fragen Sie den GET-Endpunkt nach einer kurzen Verzögerung erneut ab, oder verwenden Sie einen Webhook, um automatisch benachrichtigt zu werden, wenn der Vorgang abgeschlossen ist – siehe So funktionieren Webhooks.Nächste Schritte
Fehlerbehandlung
Sehen Sie die vollständigen Fehlermeldungen und Antwortformate für jeden Statuscode.
Authentifizierung
Übergeben Sie Ihren API-Schlüssel im x-api-key-Header, um 401-Fehler zu vermeiden.
Ratenlimits
Verstehen Sie die Schwellenwerte, die eine 429-Antwort auslösen.
Credits & Abrechnung
Sehen Sie, wie Credits verbraucht werden, und vermeiden Sie 402-Fehler.