Przejdź do głównej treści
Enrow korzysta z systemu opartego na kredytach, a kredyty są zużywane wyłącznie 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. Każda funkcja zużywa kredyty według innej stawki:
EndpointKredyty
Email Finder1 za znaleziony adres e-mail
Phone Finder40 za znaleziony numer telefonu (domyślnie; 50 w starszych planach)
Email Verifier0,25 za sprawdzenie
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ń.
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. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Odpowiedź zawiera Twoje saldo oraz zarejestrowane webhooki:
PoleOpis
creditsTwoje bieżące saldo kredytów
webhooksTablica zarejestrowanych adresów URL webhooków
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ń?

Na stronie rozliczeń w aplikacji możesz skonfigurować trzy opcje, które utrzymują Twoje konto doładowane i ostrzegają Cię, zanim kredyty się skończą:
Automatycznie odnawia Twój plan po jego wygaśnięciu. Ustaw liczbę kredytów do odnowienia w polu obok przełącznika.
Automatycznie kupuje dodatkowe kredyty pay-as-you-go, gdy Twoje saldo jest niskie. Ustaw liczbę kredytów do doładowania w polu obok przełącznika.
Otrzymuj alert e-mail, gdy saldo kredytów spadnie poniżej progu. Ustaw próg liczby kredytów w polu obok przełącznika.

​
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ą: 
{
  "reason": "Insufficient credits",
  "success": false
}
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 Automatyczne doładowanie lub Alert o niskim saldzie na stronie rozliczeń.

​
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 za pomocą Automatycznego doładowania.

​
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.
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.