Skip to main content
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 auf der API-Seite des Dashboards eine Standard-Webhook-URL festlegen. Enrow prüft die URL beim Speichern: siehe Wie verifiziere ich meinen Webhook-Endpunkt?. Diese URL wird verwendet, wann immer in einer einzelnen Anfrage kein webhook angegeben ist, sodass Sie sie nicht bei jedem Aufruf wiederholen müssen. Enthält eine Anfrage in ihrem settings-Objekt einen eigenen webhook, ersetzt dieser bei Phone-Finder- und Email-Verifier-Anfragen den Standard aus dem Dashboard. Bei Email-Finder-Anfragen benachrichtigt Enrow beide URLs. Für Payload-Formate, Zustellungen 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:
Das settings-Objekt akzeptiert außerdem webhook (eine Webhook-URL pro Anfrage) und retrieve_gender (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.
Das hängt vom Endpunkt ab. Bei Email-Finder-Suchen sendet Enrow das Ergebnis an beide URLs (nur einmal, wenn sie identisch sind). Bei Phone-Finder-Suchen und Email-Verifier-Prüfungen ersetzt der webhook pro Anfrage im settings-Objekt den Standard aus dem Dashboard, der nur verwendet wird, 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.