Zum Hauptinhalt springen
Enrow nutzt ein Credit-basiertes System, und Credits werden nur dann verbraucht, wenn ein Ergebnis gefunden oder eine Prüfung durchgeführt wird. Diese Seite erklärt, wie Credits für jeden Endpunkt berechnet werden, wie Sie Ihr Guthaben prüfen, wie Sie Abrechnungseinstellungen verwalten und was passiert, wenn die Credits aufgebraucht sind.

​
Wie funktionieren Credits?

Credits werden nur dann verbraucht, wenn die API ein Ergebnis zurückgibt oder eine Prüfung abschließt — fehlgeschlagene Abfragen, die nichts finden, kosten keine Credits. Jede Funktion verbraucht Credits zu einem anderen Satz:
EndpunktCredits
Email Finder1 pro gefundener E-Mail
Phone Finder40 pro gefundener Telefonnummer (Standard; 50 bei Legacy-Tarifen)
Email Verifier0,25 pro Prüfung
Credits werden bei Einzel- und Massenvorgängen auf dieselbe Weise berechnet — pro Einzelergebnis. Eine Massen-E-Mail-Suche mit 1.000 Namen kostet pro gefundener E-Mail genauso viel wie 1.000 Einzelsuchen.
Jede Anfrage, die Credits verbraucht, gibt in ihrer Antwort ein Feld credits_used zurück, sodass Sie den Verbrauch pro Suche verfolgen können. Ein Beispiel für eine Antwort finden Sie unter Einzelne E-Mail finden.

​
Wie prüfe ich mein Credit-Guthaben?

Fragen Sie den Konto-Endpunkt mit Ihrem API-Schlüssel im Header x-api-key ab, um Ihr aktuelles Credit-Guthaben abzurufen. Es ist kein Body-Payload erforderlich — das Konto wird anhand des API-Schlüssels identifiziert. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Antwort
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Die Antwort enthält Ihr Guthaben und die registrierten Webhooks:
FeldBeschreibung
creditsIhr aktuelles Credit-Guthaben
webhooksArray Ihrer registrierten Webhook-URLs
Die vollständige Endpunkt-Referenz finden Sie unter Konto-Info. Sie können auch Ihr Dashboard besuchen, um Nutzungs- und Abrechnungsdetails einzusehen, oder den Leitfaden Authentifizierung lesen, um zu verstehen, wie der Header x-api-key über alle Endpunkte hinweg funktioniert.

​
Wie verwalte ich Abrechnungseinstellungen?

Auf der Abrechnungsseite in der App können Sie drei Optionen konfigurieren, die Ihr Konto aufgeladen halten und Sie warnen, bevor die Credits aufgebraucht sind:
Verlängern Sie Ihren Tarif automatisch, wenn er abläuft. Legen Sie die zu verlängernde Credit-Menge im Eingabefeld neben dem Umschalter fest.
Kaufen Sie automatisch zusätzliche Pay-as-you-go-Credits, wenn Ihr Guthaben zur Neige geht. Legen Sie die aufzuladende Credit-Menge im Eingabefeld neben dem Umschalter fest.
Erhalten Sie eine E-Mail-Warnung, wenn Ihr Credit-Guthaben unter einen Schwellenwert fällt. Legen Sie den Credit-Schwellenwert im Eingabefeld neben dem Umschalter fest.

​
Was passiert, wenn die Credits aufgebraucht sind?

Wenn Ihr Credit-Guthaben null erreicht, geben API-Anfragen den HTTP-Status 402 zurück. Einzel-Endpunkte (E-Mail-/Telefon-Einzelsuche, Einzelprüfung) geben Folgendes zurück: 
{
  "reason": "Insufficient credits",
  "success": false
}
Massen-Endpunkte geben stattdessen { "message": "..." } zurück. Die vollständige Liste der Statuscodes und Antwortformate finden Sie unter Statuscodes und Fehlerbehandlung.
Um Unterbrechungen zu vermeiden, aktivieren Sie auf der Abrechnungsseite die Automatische Aufladung oder die Warnung bei niedrigem Guthaben.

​
Welchen Tarif soll ich wählen?

Besuchen Sie enrow.io/pricing, um Tarife zu vergleichen und den passenden für Ihre Anforderungen zu finden. Pay-as-you-go-Credits können über die Automatische Aufladung zu jedem Tarif hinzugefügt werden.

​
FAQ

Nein. Credits werden nur verbraucht, wenn eine E-Mail oder Telefonnummer gefunden oder eine Verifizierungsprüfung durchgeführt wird. Eine Suche, die kein Ergebnis liefert, kostet keine Credits.
Nein. Credits werden pro Einzelergebnis berechnet, sodass ein Massenvorgang pro gefundener E-Mail, Telefonnummer oder Verifizierung genauso viel kostet wie die entsprechenden Einzelanfragen. Massen-Endpunkte sparen Anfragen, nicht Credits.
Der Email Verifier verbraucht 0,25 Credits pro Prüfung. Der Email Finder verbraucht 1 Credit pro gefundener E-Mail, und der Phone Finder verbraucht 40 Credits pro gefundener Telefonnummer (50 bei Legacy-Tarifen).
Anfragen geben den HTTP-Status 402 zurück. Einzel-Endpunkte geben { "reason": "Insufficient credits", "success": false } zurück, während Massen-Endpunkte { "message": "..." } zurückgeben. Weitere Details finden Sie unter Fehlerbehandlung.

​
Nächste Schritte

Authentifizierung

So übergeben Sie Ihren API-Schlüssel im Header x-api-key.

Konto-Info

Rufen Sie Ihr Credit-Guthaben und die registrierten Webhooks ab.

Rate-Limits

Verstehen Sie die API-Anfragelimits, bevor Sie skalieren.

Fehlerbehandlung

Behandeln Sie 402 und andere Fehlerantworten elegant.