Przejdź do głównej treści
Ustawienia API określają, w jaki sposób uzyskujesz dostęp do API Enrow i jak zachowuje się ono przy każdym żądaniu. Ta strona opisuje, kto może korzystać z API, gdzie znaleźć swój klucz API, jak ustawić domyślny adres URL webhooka oraz jak parametr country_code zmienia działanie wyszukiwania.

​
Kto może korzystać z API Enrow?

API Enrow jest dostępne dla klientów z aktywną subskrypcją lub kredytami w modelu pay-as-you-go. Jeśli Twoje konto nie ma żadnej z tych opcji, sekcja API nie będzie dostępna. Aby zobaczyć, ile kredytów zużywa każdy endpoint, zobacz Kredyty i rozliczenia.

​
Gdzie znajdę swój klucz API?

Twój klucz API znajduje się w panelu Enrow — kliknij API w menu po lewej stronie i skopiuj klucz. Ten sam klucz uwierzytelnia każdy endpoint za pośrednictwem nagłówka x-api-key. Przykłady żądań i obsługę błędów znajdziesz w sekcji Uwierzytelnianie.
Przechowuj swój klucz API w bezpiecznym miejscu. Nigdy nie umieszczaj klucza API w systemie kontroli wersji ani nie udostępniaj go publicznie. Traktuj go jak hasło.

​
Jak ustawić domyślny adres URL webhooka?

Domyślny adres URL webhooka możesz skonfigurować w panelu. Ten adres URL jest używany za każdym razem, gdy w pojedynczym żądaniu nie podano parametru webhook, dzięki czemu nie musisz go powtarzać przy każdym wywołaniu. Parametr webhook podany w obiekcie settings w danym żądaniu zawsze nadpisuje wartość domyślną z panelu. Informacje o formatach payloadu, ponownych próbach oraz bezpieczeństwie znajdziesz w sekcji Jak działają webhooki.

​
Co robi parametr country_code?

Parametr country_code (ISO 3166-1 alpha-2) określa, której lokalnej wersji Google używa API do zidentyfikowania firmy. Podaj go w obiekcie settings swojego żądania. Jeśli nic nie zostanie podane, wartością domyślną jest US.
Kod kraju jest przydatny tylko podczas wyszukiwania z użyciem company_name (a nie company_domain). Wskazuje on Enrow, której lokalnej wersji Google użyć do zidentyfikowania firmy — na przykład google.de dla Niemiec lub google.fr dla Francji.
Kod kraju jest szczególnie przydatny w przypadku homonimów — firm o tej samej nazwie w różnych krajach: 
// 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" }
}
Obiekt settings przyjmuje również parametry webhook (adres URL webhooka dla danego żądania), retrieve_gender (wartość logiczna) oraz retrieve_company_info (wartość logiczna). Pełną listę dostępnych ustawień znajdziesz w dokumentacji Find Single Email.

​
FAQ

Nie. Jeden klucz API uwierzytelnia każdy endpoint — Email Finder, Email Verifier oraz Phone Finder. Podaj klucz w nagłówku x-api-key przy każdym żądaniu.
Nie. Parametr country_code wpływa tylko na wyszukiwania korzystające z company_name. Gdy podajesz company_domain, domena już identyfikuje firmę, więc kod kraju nie ma żadnego wpływu.
Pierwszeństwo ma parametr webhook podany w obiekcie settings dla danego żądania. Wartość domyślna z panelu jest używana tylko wtedy, gdy żądanie nie zawiera własnego adresu URL webhook.

​
Następne kroki

Uwierzytelnianie

Jak przekazać swój klucz API w nagłówku x-api-key.

Jak działają webhooki

Skonfiguruj webhooki, aby otrzymywać powiadomienia po zakończeniu wyszukiwania.

Kredyty i rozliczenia

Zobacz, ile kredytów zużywa każdy endpoint.

Znajdź adres e-mail

Uruchom pojedyncze wyszukiwanie adresu e-mail z niestandardowymi ustawieniami.