Przejdź do głównej treści
API Enrow korzysta z uwierzytelniania za pomocą klucza API. Każde żądanie musi zawierać Twój klucz API w nagłówku x-api-key. Nie ma żadnych przepływów OAuth ani tokenów bearer do zarządzania — jeden klucz API uwierzytelnia każdy punkt końcowy.

​
Jak uzyskać klucz API?

  1. Zarejestruj się na app.enrow.io
  2. Kliknij API w menu po lewej stronie
  3. Skopiuj swój klucz API
Przechowuj swój klucz API w bezpieczny sposób i nigdy nie umieszczaj go w systemie kontroli wersji. Traktuj go jak hasło. Jeśli klucz kiedykolwiek zostanie ujawniony, wygeneruj go ponownie — zobacz Najlepsze praktyki.

​
Jak uwierzytelnić żądanie?

Dołącz swój klucz API w nagłówku x-api-key przy każdym żądaniu: 
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"
  }'
Ten sam nagłówek x-api-key działa dla każdego punktu końcowego — Email Finder, Email Verifier, Phone Finder oraz Informacje o koncie.

​
Dlaczego otrzymuję błąd 401?

Odpowiedź 401 Unauthorized oznacza, że Twój klucz API jest brakujący lub nieprawidłowy. Jeśli klucz API jest nieprawidłowy, otrzymasz: 
{
  "message": "This apikey is not valid"
}
Jeśli nie podano żadnego klucza API, komunikat message przyjmuje zamiast tego wartość "No apikey found in the x-api-key headers". Pełną listę kodów statusu i formatów błędów znajdziesz w sekcjach Kody statusu oraz Obsługa błędów.

​
Jak sprawdzić swoje konto i kredyty?

Informacje o swoim koncie (saldo kredytów i zarejestrowane webhooki) możesz pobrać za pomocą tego samego nagłówka x-api-key — nie jest wymagana żadna treść żądania: 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Odpowiedź
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Aby zrozumieć, jak kredyty są zużywane przez poszczególne punkty końcowe, zobacz Kredyty i rozliczenia.

​
Najlepsze praktyki

Przechowuj swój klucz API w zmiennych środowiskowych, zamiast wpisywać go na stałe w kodzie:
export ENROW_API_KEY="your_api_key_here"
Dla zwiększenia bezpieczeństwa okresowo zmieniaj swoje klucze API i usuwaj nieużywane klucze.
Twórz osobne klucze API dla środowisk programistycznego, testowego i produkcyjnego.

​
Następne kroki

Znajdź e-mail

Wyszukaj służbowy adres e-mail na podstawie imienia, nazwiska i firmy.

Zweryfikuj e-mail

Sprawdź, czy adres e-mail jest prawidłowy i możliwy do dostarczenia.

Kredyty i rozliczenia

Zobacz, jak kredyty są zużywane przez poszczególne punkty końcowe.

Limity zapytań

Poznaj limity żądań API, zanim zwiększysz skalę.