Zum Hauptinhalt springen
Die Enrow-API verwendet die Authentifizierung per API-Schlüssel. Jede Anfrage muss Ihren API-Schlüssel im x-api-key-Header enthalten. Es gibt keine OAuth-Flows oder Bearer-Tokens zu verwalten — ein einziger API-Schlüssel authentifiziert jeden Endpunkt.

​
Wie erhalte ich meinen API-Schlüssel?

  1. Registrieren Sie sich unter app.enrow.io
  2. Klicken Sie im linken Menü auf API
  3. Kopieren Sie Ihren API-Schlüssel
Bewahren Sie Ihren API-Schlüssel sicher auf und übertragen Sie ihn niemals in die Versionsverwaltung. Behandeln Sie ihn wie ein Passwort. Falls ein Schlüssel jemals offengelegt wird, rotieren Sie ihn — siehe Best Practices.

​
Wie authentifiziere ich eine Anfrage?

Fügen Sie Ihren API-Schlüssel bei jeder Anfrage im x-api-key-Header hinzu: 
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "John Doe",
    "company_domain": "example.com"
  }'
Derselbe x-api-key-Header funktioniert für jeden Endpunkt — Email Finder, Email Verifier, Phone Finder und Kontoinformationen.

​
Warum erhalte ich einen 401-Fehler?

Eine 401 Unauthorized-Antwort bedeutet, dass Ihr API-Schlüssel fehlt oder ungültig ist. Wenn der API-Schlüssel ungültig ist, erhalten Sie: 
{
  "message": "This apikey is not valid"
}
Wenn kein API-Schlüssel angegeben wird, lautet die message stattdessen "No apikey found in the x-api-key headers". Die vollständige Liste der Statuscodes und Fehlerformate finden Sie unter Statuscodes und Fehlerbehandlung.

​
Wie überprüfe ich mein Konto und meine Credits?

Sie können Ihre Kontoinformationen (Credits-Guthaben und registrierte Webhooks) mit demselben x-api-key-Header abrufen — es ist keine Body-Payload erforderlich: 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Wie Credits pro Endpunkt verbraucht werden, erfahren Sie unter Credits & Abrechnung.

​
Best Practices

Speichern Sie Ihren API-Schlüssel in Umgebungsvariablen, anstatt ihn fest im Code zu hinterlegen:
export ENROW_API_KEY="your_api_key_here"
Für erhöhte Sicherheit sollten Sie Ihre API-Schlüssel in regelmäßigen Abständen rotieren und nicht genutzte Schlüssel widerrufen.
Erstellen Sie separate API-Schlüssel für Entwicklungs-, Staging- und Produktionsumgebungen.

​
Nächste Schritte

E-Mail finden

Suchen Sie eine berufliche E-Mail-Adresse anhand eines Namens und eines Unternehmens.

E-Mail verifizieren

Prüfen Sie, ob eine E-Mail-Adresse gültig und zustellbar ist.

Credits & Abrechnung

Erfahren Sie, wie Credits für jeden Endpunkt verbraucht werden.

Rate-Limits

Verstehen Sie die API-Anfragelimits, bevor Sie hochskalieren.