Zum Hauptinhalt springen
API-Einstellungen steuern, wie Sie auf die Enrow-API zugreifen und wie sie sich bei jeder Anfrage verhält. Diese Seite behandelt, wer auf die API zugreifen kann, wo Sie Ihren API-Schlüssel finden, wie Sie eine Standard-Webhook-URL festlegen und wie der Parameter country_code das Suchverhalten verändert.

​
Wer kann auf die Enrow-API zugreifen?

Die Enrow-API steht Kunden mit einem aktiven Abonnement oder Pay-as-you-go-Guthaben zur Verfügung. Wenn Ihr Konto über keines von beidem verfügt, ist der API-Bereich nicht zugänglich. Um zu sehen, wie Guthaben pro Endpunkt verbraucht wird, siehe Guthaben & Abrechnung.

​
Wo finde ich meinen API-Schlüssel?

Ihren API-Schlüssel finden Sie im Enrow-Dashboard — klicken Sie im linken Menü auf API und kopieren Sie den Schlüssel. Derselbe Schlüssel authentifiziert jeden Endpunkt über den x-api-key-Header. Für Anfragebeispiele und Fehlerbehandlung siehe Authentifizierung.
Bewahren Sie Ihren API-Schlüssel sicher auf. Übertragen Sie den API-Schlüssel niemals in die Versionskontrolle und geben Sie ihn nicht öffentlich weiter. Behandeln Sie ihn wie ein Passwort.

​
Wie lege ich eine Standard-Webhook-URL fest?

Sie können im Dashboard eine Standard-Webhook-URL konfigurieren. Diese URL wird verwendet, wann immer in einer einzelnen Anfrage kein webhook angegeben ist, sodass Sie sie nicht bei jedem Aufruf wiederholen müssen. Ein webhook pro Anfrage im settings-Objekt überschreibt immer den Standard aus dem Dashboard. Für Payload-Formate, Wiederholungsversuche und Sicherheit siehe So funktionieren Webhooks.

​
Was bewirkt der Parameter country_code?

Der Parameter country_code (ISO 3166-1 alpha-2) legt fest, welche lokale Version von Google die API zur Auflösung eines Unternehmens verwendet. Übergeben Sie ihn im settings-Objekt Ihrer Anfrage. Wird nichts angegeben, ist der Standardwert US.
Der Ländercode ist nur bei der Suche mit company_name (nicht company_domain) nützlich. Er teilt Enrow mit, welche lokale Version von Google zur Auflösung des Unternehmens verwendet werden soll — zum Beispiel google.de für Deutschland oder google.fr für Frankreich.
Der Ländercode ist besonders nützlich bei Homonymen — Unternehmen, die in verschiedenen Ländern denselben Namen tragen: 
// Dove the soap brand (UK)
{
  "company_name": "Dove",
  "fullname": "John Doe",
  "settings": { "country_code": "GB" }
}

// Dove the chocolate brand (Germany)
{
  "company_name": "Dove",
  "fullname": "Hans Müller",
  "settings": { "country_code": "DE" }
}
Das settings-Objekt akzeptiert außerdem webhook (eine Webhook-URL pro Anfrage), retrieve_gender (boolean) und retrieve_company_info (boolean). Die vollständige Liste der verfügbaren Einstellungen finden Sie in der Referenz E-Mail finden.

​
FAQ

Nein. Ein API-Schlüssel authentifiziert jeden Endpunkt — Email Finder, Email Verifier und Phone Finder. Übergeben Sie den Schlüssel bei jeder Anfrage im x-api-key-Header.
Nein. Der Parameter country_code wirkt sich nur auf Suchen aus, die company_name verwenden. Wenn Sie eine company_domain übergeben, identifiziert die Domain das Unternehmen bereits, sodass der Ländercode keine Wirkung hat.
Der webhook pro Anfrage im settings-Objekt hat Vorrang. Der Standard aus dem Dashboard wird nur verwendet, wenn eine Anfrage keine eigene webhook-URL enthält.

​
Nächste Schritte

Authentifizierung

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

So funktionieren Webhooks

Richten Sie Webhooks ein, um benachrichtigt zu werden, wenn eine Suche abgeschlossen ist.

Guthaben & Abrechnung

Sehen Sie, wie Guthaben für jeden Endpunkt verbraucht wird.

E-Mail finden

Führen Sie eine einzelne E-Mail-Suche mit benutzerdefinierten Einstellungen durch.