Skip to main content
Enrow korzysta z systemu opartego na kredytach, a kredyty są zużywane wtedy, gdy zostanie znaleziony wynik lub wykonane sprawdzenie. Ta strona wyjaśnia, jak naliczane są kredyty dla każdego endpointu, jak sprawdzić saldo, jak zarządzać ustawieniami rozliczeń oraz co się dzieje, gdy kredyty się skończą.

​
Jak działają kredyty?

Kredyty są zużywane wyłącznie wtedy, gdy API zwróci wynik lub ukończy sprawdzenie: nieudane wyszukiwania, które niczego nie znajdą, nie kosztują kredytów, z dwoma wyjątkami dla Email Finder (zobacz poniżej). Każda funkcja zużywa kredyty według innej stawki:
Kredyty są naliczane tak samo dla operacji pojedynczych i masowych — za każdy pojedynczy wynik. Masowe wyszukiwanie adresów e-mail dla 1000 nazwisk kosztuje za każdy znaleziony adres e-mail tyle samo, co 1000 pojedynczych wyszukiwań.
Dwa wyjątki dla Email Finder: konto, którego wskaźnik skuteczności pozostaje nienormalnie niski, po ostrzeżeniu płaci 0,25 kredytu za każde wyszukiwanie bez wyniku, a wyszukiwanie na podstawie adresu URL profilu LinkedIn kosztuje 0,25 kredytu, jeśli nie zostanie znaleziony żaden adres e-mail. Zobacz FAQ poniżej.
Każde żądanie, które zużywa kredyty, zwraca w odpowiedzi pole credits_used, dzięki czemu możesz śledzić zużycie dla poszczególnych wyszukiwań. Przykładową odpowiedź znajdziesz w Find Single Email.

​
Jak sprawdzić saldo kredytów?

Aby pobrać bieżące saldo kredytów, wyślij zapytanie do endpointu konta z kluczem API w nagłówku x-api-key. Nie jest wymagane żadne ciało żądania — konto jest identyfikowane na podstawie klucza API.
Response
Odpowiedź zawiera Twoje saldo oraz zarejestrowane webhooki: Pełną dokumentację endpointu znajdziesz w Account info. Możesz też odwiedzić swój Dashboard, aby zobaczyć szczegóły zużycia i rozliczeń, lub zajrzeć do przewodnika Authentication, aby dowiedzieć się, jak nagłówek x-api-key działa we wszystkich endpointach.

​
Jak zarządzać ustawieniami rozliczeń?

W planach płatnych sekcja Rozliczenia → Ustawienia w aplikacji zawiera dwa ustawienia, które utrzymują zapas kredytów na Twoim koncie i ostrzegają Cię, zanim kredyty się skończą:
Automatycznie doładowuje Twoje saldo, gdy tylko spadnie ono poniżej progu ustawionego w polu Credit threshold (co najmniej 100 kredytów). Wybierz jeden z dwóch trybów:
  • Early renewal: Twój plan odnawia się od razu i rozpoczyna nowy cykl ze swoją pulą kredytów. Dostępne tylko przy aktywnej subskrypcji.
  • Pay-as-you-go top-up: kupowany jest pakiet kredytów pay-as-you-go o wielkości ustawionej w polu Top-up volume.
Jeśli w momencie zapisywania Twoje saldo jest już poniżej progu, doładowanie następuje od razu.
Wysyła e-mail na wybrany przez Ciebie adres, gdy saldo spadnie poniżej wskazanej liczby kredytów. Ten alert możesz też publikować na kanale Slack lub Discord.

​
Co się dzieje, gdy kredyty się skończą?

Gdy saldo kredytów osiągnie zero, żądania API zwracają status HTTP 402. Pojedyncze endpointy (find single dla e-maila/telefonu, verify single) zwracają:
Endpointy masowe zwracają zamiast tego { "message": "..." }. Pełną listę kodów statusu i struktur odpowiedzi znajdziesz w Status codes oraz Error handling.
Aby uniknąć przerw w działaniu, włącz Balance protection lub Credit Alert w sekcji Rozliczenia → Ustawienia.

​
Który plan wybrać?

Odwiedź enrow.io/pricing, aby porównać plany i znaleźć rozwiązanie odpowiednie do Twoich potrzeb. Kredyty pay-as-you-go można dodać do dowolnego planu ręcznie lub automatycznie za pomocą Balance protection.

​
FAQ

Nie. Kredyty są zużywane wyłącznie wtedy, gdy zostanie znaleziony adres e-mail lub numer telefonu albo gdy zostanie wykonane sprawdzenie weryfikacyjne. Wyszukiwanie, które nie zwraca żadnego wyniku, nie kosztuje kredytów. Jeden wyjątek, określony w punkcie 8.6 naszego regulaminu: jeśli mniej niż 12% wyszukiwań Email Finder na koncie znajduje adres e-mail, przy co najmniej 10 000 wyszukiwań w ciągu 7 dni, ostrzegamy konto e-mailem. Jeśli po 7 dniach wskaźnik nadal jest tak niski, każde wyszukiwanie Email Finder bez wyniku kosztuje 0,25 kredytu, dopóki wskaźnik nie wzrośnie. Drugi wyjątek: wyszukiwanie Email Finder na podstawie adresu URL profilu LinkedIn kosztuje 0,25 kredytu, jeśli nie zostanie znaleziony żaden adres e-mail. Niepowodzenia spowodowane incydentem po naszej stronie nigdy nie są obciążane.
Nie. Kredyty są naliczane za każdy pojedynczy wynik, więc operacja masowa kosztuje za każdy znaleziony adres e-mail, numer telefonu lub weryfikację tyle samo, co odpowiadające jej pojedyncze żądania. Endpointy masowe pozwalają zaoszczędzić na liczbie żądań, a nie na kredytach.
Email Verifier zużywa 0,25 kredytu za sprawdzenie. Email Finder zużywa 1 kredyt za znaleziony adres e-mail, a Phone Finder zużywa 40 kredytów za znaleziony numer telefonu (50 w starszych planach).
Żądania zwracają status HTTP 402. Pojedyncze endpointy zwracają { "reason": "Insufficient credits", "success": false }, natomiast endpointy masowe zwracają { "message": "..." }. Szczegóły znajdziesz w Error handling.

​
Następne kroki

Authentication

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

Account info

Pobierz saldo kredytów i zarejestrowane webhooki.

Rate limits

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

Error handling

Obsługuj 402 i inne odpowiedzi błędów w prawidłowy sposób.