> ## Documentation Index > Fetch the complete documentation index at: https://docs.enrow.io/llms.txt > Use this file to discover all available pages before exploring further. # Kody statusu > Dokumentacja kodów statusu HTTP API Enrow oraz wartości kwalifikacji wyszukiwania, abyś wiedział, jak obsłużyć każdą odpowiedź API Enrow używa standardowych kodów statusu HTTP do wskazania wyniku każdego żądania, a także pola `qualification`, które informuje o rezultacie wyszukiwania lub weryfikacji. Ta strona zawiera listę wszystkich kodów i wartości kwalifikacji, dzięki czemu możesz niezawodnie obsługiwać odpowiedzi. Pasujące komunikaty błędów i formaty odpowiedzi znajdziesz w sekcji [Obsługa błędów](/pl/error-handling). ## Jakie kody statusu HTTP zwraca API? API Enrow używa standardowych kodów statusu HTTP do wskazania wyniku każdego żądania. Kod `2xx` oznacza, że żądanie się powiodło, kod `4xx` wskazuje na problem z żądaniem, a kod `5xx` oznacza, że coś poszło nie tak po stronie Enrow. ### Które kody oznaczają sukces? Kod statusu `2xx` oznacza, że API zaakceptowało żądanie. Operacje asynchroniczne (takie jak wyszukiwania zbiorcze) zwracają `201` lub `202`, ponieważ praca jest kontynuowana w tle. | Kod | Znaczenie | Opis | | ------- | --------- | -------------------------------------------------------- | | **200** | OK | Żądanie powiodło się, zwrócono wyniki | | **201** | Created | Zasób utworzony (np. zainicjowano wyszukiwanie zbiorcze) | | **202** | Accepted | Żądanie zaakceptowane, przetwarzanie asynchroniczne | ### Które kody oznaczają odrzucenie żądania? Kod statusu `4xx` oznacza, że API odrzuciło żądanie z powodu czegoś, co można naprawić po stronie klienta — nieprawidłowe parametry, brakujący lub nieprawidłowy klucz API, niewystarczające kredyty lub zbyt wiele żądań. | Kod | Znaczenie | Opis | | ------- | ----------------- | ------------------------------------- | | **400** | Bad Request | Nieprawidłowe lub brakujące parametry | | **401** | Unauthorized | Nieprawidłowy lub brakujący klucz API | | **402** | Payment Required | Niewystarczające kredyty | | **429** | Too Many Requests | Przekroczono limit żądań | Kod `401` oznacza, że klucz API jest brakujący lub nieprawidłowy — zobacz [Uwierzytelnianie](/pl/authentication), aby dowiedzieć się, jak przekazać go poprawnie. Kod `402` oznacza, że na koncie skończyły się kredyty; sprawdź zużycie w sekcji [Kredyty i rozliczenia](/pl/credits-billing). Kod `429` oznacza, że żądanie przekroczyło dozwoloną przepustowość — zobacz [Limity żądań](/pl/rate-limits), aby zrozumieć progi. API nigdy nie zwraca kodu **404**. Nieznany lub wygasły identyfikator wyszukiwania zwraca **400** dla endpointów zbiorczych i **500** dla endpointów pojedynczych. ### Które kody oznaczają błąd serwera? Kod statusu `5xx` oznacza, że żądanie było prawidłowe, ale coś poszło nie tak po stronie Enrow. Te odpowiedzi można bezpiecznie ponowić po krótkim opóźnieniu. | Kod | Znaczenie | Opis | | ------- | --------------------- | ------------------------------------ | | **500** | Internal Server Error | Coś poszło nie tak po naszej stronie | ## Czym są kwalifikacje wyszukiwania? Kwalifikacja wyszukiwania to wartość w polu `qualification`, która informuje o wyniku wyszukiwania lub weryfikacji. Enrow zwraca to pole we wszystkich endpointach, a wynik jest zawsze **binarny** — nie ma odpowiedzi „być może" ani oceny prawdopodobieństwa. To celowy wybór projektowy. ### Dlaczego wynik jest binarny? Wynik jest binarny, ponieważ jasna odpowiedź „tak lub nie" jest łatwiejsza do wykorzystania niż prawdopodobieństwo. Większość narzędzi do wzbogacania danych zwraca złożony zestaw kategorii — catch-all, ryzykowny, nieznany, nieweryfikowalny itp. — które zmuszają do budowania logiki wokół prawdopodobieństw. Enrow przyjął odwrotne podejście: * **Enrow weryfikuje deterministycznie nawet adresy catch-all**, więc nie ma potrzeby stosowania kategorii „catch-all" * Enrow nie wierzy w systemy probabilistyczne z dziesiątkami klasyfikacji — dodają one złożoność bez przejrzystości * Wynik binarny oznacza, że możesz działać na danych natychmiast, bez wątpliwości Wynik jest albo dobry, albo nie. Proste. ### Jakie kwalifikacje zwraca Email Finder? [Email Finder](/pl/api-reference/email-finder/find-single) zwraca jedną z następujących wartości w polu `qualification`: | Kwalifikacja | Znaczenie | | ------------ | --------------------------------------- | | `valid` | Adres e-mail znaleziony i zweryfikowany | | `invalid` | Adres e-mail nie został znaleziony | | `ongoing` | Wyszukiwanie nadal w toku | ### Jakie kwalifikacje zwraca Email Verifier? [Email Verifier](/pl/api-reference/email-verifier/verify-single) zwraca jedną z następujących wartości w polu `qualification`: | Kwalifikacja | Znaczenie | | ------------ | --------------------------------------------------- | | `valid` | Adres e-mail jest prawidłowy i dostarczalny | | `invalid` | Adres e-mail jest nieprawidłowy lub niedostarczalny | | `ongoing` | Weryfikacja nadal w toku | `invalid` oznacza różne rzeczy w zależności od endpointu: w **Email Finder** oznacza, że adres e-mail nie został znaleziony. W **Email Verifier** oznacza, że adres e-mail istnieje, ale nie jest dostarczalny. ### Jakie kwalifikacje zwraca Phone Finder? [Phone Finder](/pl/api-reference/phone/find-single) zwraca jedną z następujących wartości w polu `qualification`: | Kwalifikacja | Znaczenie | | ------------ | -------------------------------------- | | `found` | Numer telefonu pomyślnie zlokalizowany | | `not_found` | Nie udało się znaleźć numeru telefonu | | `ongoing` | Wyszukiwanie nadal w toku | ### Jak śledzić wyszukiwanie zbiorcze? W przypadku operacji zbiorczych pole `status` wskazuje postęp partii. Odpytuj odpowiedni endpoint GET — [Wyniki zbiorcze Email Finder](/pl/api-reference/email-finder/get-bulk-results), [Weryfikacje zbiorcze Email Verifier](/pl/api-reference/email-verifier/get-bulk-verifications) lub [Wyniki zbiorcze Phone Finder](/pl/api-reference/phone/get-bulk-results) — aż `status` osiągnie wartość `completed`. | Status | Znaczenie | | ----------- | -------------------------------------------------- | | `ongoing` | Partia jest nadal przetwarzana | | `completed` | Wszystkie wyszukiwania w partii zostały zakończone | | `failed` | Partia zakończyła się niepowodzeniem | ## FAQ Kod `401 Unauthorized` oznacza, że klucz API jest brakujący lub nieprawidłowy. Upewnij się, że każde żądanie zawiera prawidłowy klucz w nagłówku `x-api-key`. Szczegóły znajdziesz w sekcji [Uwierzytelnianie](/pl/authentication). Kod `402 Payment Required` oznacza, że konto nie ma wystarczającej liczby kredytów do zrealizowania żądania. Doładuj saldo lub sprawdź, jak kredyty są zużywane na poszczególnych endpointach, w sekcji [Kredyty i rozliczenia](/pl/credits-billing). API Enrow nigdy nie zwraca kodu `404`. Nieznany lub wygasły identyfikator wyszukiwania zwraca `400` dla endpointów zbiorczych i `500` dla endpointów pojedynczych. Sprawdź dokładnie identyfikator `id` zwrócony podczas inicjowania wyszukiwania. Nie. `ongoing` oznacza, że wyszukiwanie lub weryfikacja są nadal w toku. Odpytaj endpoint GET ponownie po krótkim opóźnieniu lub użyj webhooka, aby otrzymać automatyczne powiadomienie po zakończeniu — zobacz [Jak działają webhooki](/pl/how-webhooks-work). ## Następne kroki Zobacz pełne komunikaty błędów i formaty odpowiedzi dla każdego kodu statusu. Przekaż swój klucz API w nagłówku x-api-key, aby uniknąć błędów 401. Zrozum progi, które wywołują odpowiedź 429. Zobacz, jak zużywane są kredyty i unikaj błędów 402.