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.
Jakie kody statusu HTTP zwraca API?
API Enrow używa standardowych kodów statusu HTTP do wskazania wyniku każdego żądania. Kod2xx 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 statusu2xx 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 statusu4xx 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ń |
401 oznacza, że klucz API jest brakujący lub nieprawidłowy — zobacz Uwierzytelnianie, 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. Kod 429 oznacza, że żądanie przekroczyło dozwoloną przepustowość — zobacz Limity żądań, 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 statusu5xx 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 poluqualification, 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
Jakie kwalifikacje zwraca Email Finder?
Email Finder zwraca jedną z następujących wartości w poluqualification:
| 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 zwraca jedną z następujących wartości w poluqualification:
| 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 zwraca jedną z następujących wartości w poluqualification:
| 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 polestatus wskazuje postęp partii. Odpytuj odpowiedni endpoint GET — Wyniki zbiorcze Email Finder, Weryfikacje zbiorcze Email Verifier lub Wyniki zbiorcze Phone Finder — 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
Dlaczego otrzymuję 401 zamiast 200?
Dlaczego otrzymuję 401 zamiast 200?
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.Co oznacza kod statusu 402?
Co oznacza kod statusu 402?
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.Dlaczego nieznany identyfikator wyszukiwania zwraca 400 lub 500 zamiast 404?
Dlaczego nieznany identyfikator wyszukiwania zwraca 400 lub 500 zamiast 404?
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.Czy qualification: ongoing oznacza, że coś się nie powiodło?
Czy qualification: ongoing oznacza, że coś się nie powiodło?
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.Następne kroki
Obsługa błędów
Zobacz pełne komunikaty błędów i formaty odpowiedzi dla każdego kodu statusu.
Uwierzytelnianie
Przekaż swój klucz API w nagłówku x-api-key, aby uniknąć błędów 401.
Limity żądań
Zrozum progi, które wywołują odpowiedź 429.
Kredyty i rozliczenia
Zobacz, jak zużywane są kredyty i unikaj błędów 402.