Wyniki żądań

Każde żądanie do API FourA jest klasyfikowane do dokładnie jednego wyniku, podobnie jak każdy tunel przez port proxy. Wynik jest obliczany raz, na końcu wywołania, i zapisywany na koncie danych uwierzytelniających, które je wykonały. Twój pulpit nawigacyjny, kanał aktywności i rozliczenia korzystają z tego samego pola.

Tylko success kosztuje kredyty. Ruch premium jest liczony niezależnie od kredytów i nie zależy od wyniku: zobacz Konsekwencje rozliczeniowe.

Siedem wyników

Oto siedem stanów, którymi może zakończyć się żądanie. Tunel używa pięciu z nich: zobacz Tunele używają tego samego słownictwa poniżej.

Wynik Warstwa Co oznacza
success nd. Zwrócono poprawną odpowiedź. Wlicza się do Twojego płatnego limitu.
application_error target Cel zwrócił HTTP 200, ale treść zawierała pole błędu lub jest stroną weryfikacji botów bądź odmowy rozpoznawaną przez FourA.
application_fail target Cel zwrócił status inny niż 200, którego Twoje reguły validate nie zaakceptowały lub dla którego nie przesłano validate, albo w ogóle brak odpowiedzi, w tym brak możliwości rozwiązania nazwy hosta docelowego.
client_error caller Twoje żądanie zostało odrzucone, zanim opuściło FourA. Błędne parametry, nieprawidłowa wartość proxy, adres URL zablokowany przez ochronę SSRF.
rate_limit FourA Żądanie zostało odrzucone przed uruchomieniem: przez jeden z limitów Twojego planu (403 dla endpointu lub parametru nieuwzględnionego w planie, 429 dla wyczerpanego limitu) albo przez współdzielony limit RPM lub współbieżności platformy.
service_error FourA Silnik odpowiedział błędem serwera lub treść odpowiedzi nie była poprawnym kodem JSON.
service_fail FourA Wystąpił błąd własnej sieci FourA: silnik nie odpowiedział na czas, połączenie zostało przerwane lub nastąpiło rozłączenie z Twojej strony.

Kolumna warstwy wskazuje, kto ponosi odpowiedzialność:

  • Wyniki target dotyczą wywoływanej witryny. Twoje żądanie dotarło poprawnie do FourA, a FourA poprawnie połączyło się z celem. Sam cel zwrócił błąd.
  • Wyniki caller oznaczają, że Twoje żądanie nie miało szans na powodzenie. Popraw strukturę żądania.
  • Wyniki FourA leżą po naszej stronie. Ponów próbę i sprawdź stronę statusu, jeśli problem będzie się powtarzał.

Witryna docelowa zwracająca 403 to application_fail, a nie client_error. Twoje wywołanie było poprawnie sformatowane. Witryna po prostu odmówiła odpowiedzi.

Jak wygląda nieudane wywołanie

Wywołanie, które dotarło do FourA i zostało wykonane, zwraca kod HTTP 200 bez względu na to, co wydarzyło się później. Tylko odmowa przed pobraniem (400, 401, 403, 413, 429) lub błąd po stronie FourA (5xx) używa innego statusu HTTP. Dlatego wynik odczytuje się z treści, a nie ze statusu warstwy transportowej.

Body Co się stało Wynik
status: 200, headers, data, brak error Strona została dostarczona. success
status inny niż 200, headers, data, brak error Cel odpowiedział i nie wysłano validate. Jego odpowiedź znajduje się w data. application_fail
status inny niż 200, headers, data i error Cel odpowiedział, a Twoje reguły validate go odrzuciły, na przykład Status 404 is not in accept list 200. application_fail
status: 200, headers, data i error Cel odpowiedział HTTP 200, a Twoje reguły validate go odrzuciły, na przykład Data not in accept list ["product"]. application_error
tylko error i total_time, brak status, brak data Cel nigdy nie odpowiedział przez HTTP: osiągnięto limit przekierowań (Number of redirects hit maximum amount), przekroczono limit czasu połączenia lub odczytu, połączenie zostało zresetowane lub odpowiedź była pusta. Tekst to powód zwrócony przez sam silnik. application_fail
status: 0 i error, nic więcej Nazwa hosta nie może zostać rozwiązana: could not resolve <host>: <reason>. Żaden silnik nie został uruchomiony, a w trybie Auto nie ma meta. Ponowienie próby nic nie zmieni, dopóki nie zmieni się stan DNS. application_fail

Pętla przekierowań z perspektywy piątego wiersza:

{
  "error": "Number of redirects hit maximum amount",
  "total_time": 0.808
}

W POST /api/proxy/ wywołanie, któremu skończą się próby, zwraca error: Download maxTry limit reached oraz attemptReport z licznikami (zobacz API Errors). W POST /api/auto/ sekwencja (ladder), która została uruchomiona i zakończyła się niepowodzeniem, zwraca status, error, attempts, attemptReport z przyczynami oraz meta.rung ustawione na fail.

X-FourA-Credits raportuje wykonaną pracę, również w przypadku błędu. Rozliczenia uwzględniają wyłącznie success, więc żaden z powyższych nieudanych wariantów nie jest taryfikowany.

Sukces uwzględnia validate

Bez validate API oznacza request jako success tylko wtedy, gdy cel zwraca HTTP 200.

Z validate sukces zależy od zdefiniowanych przez Ciebie reguł. Jeśli wskażesz w API, że zarówno 200, jak i 403 są dopuszczalne dla danego requestu, kod 403 zostanie zwrócony jako success. Body wciąż trafia do Ciebie w niezmienionej formie.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "GET",
    "url": "https://target.example/feed",
    "validate": {
      "status": { "accept": [200, 403] }
    }
  }'

W tym wywołaniu odpowiedź 403 liczy się jako success i jest rozliczana jako jedno żądanie. Odpowiedź 500 liczy się jako application_fail i nie podlega opłacie.

Ta sama logika dotyczy validate.headers oraz validate.data. Każda odpowiedź zaakceptowana przez silnik zgodnie z Twoimi regułami wraca jako success niezależnie od statusu HTTP.

Jedna odpowiedź nigdy nie jest traktowana jako success, z validate lub bez niego: to HTTP 200, którego treść jest stroną weryfikacji botów rozpoznawaną przez FourA, taką jak zadanie weryfikacji wizualnej, strona wymagająca jedynie uruchomienia JavaScriptu w przeglądarce, lub strona odmowy zwracana przez witrynę ze statusem HTTP 200. Takie żądanie to application_error i nie jest rozliczane. Treść nadal dociera do Ciebie bez zmian, a nagłówek X-FourA-Check-Page wskazuje tę stronę.

Skutki rozliczeniowe

Wynik Płatne Wlicza się do limitu
success Tak Tak
application_error Nie Nie
application_fail Nie Nie
client_error Nie Nie
rate_limit Nie Nie
service_error Nie Nie
service_fail Nie Nie

Rozliczane są wyłącznie żądania, które dostarczyły żądane dane. Błędy po stronie FourA, po stronie celu lub po Twojej stronie są bezpłatne.

Tabela dotyczy kredytów. Ruch premium jest zliczany osobno: żądanie, które próbowało użyć węzła wyjściowego premium, zlicza ruch przesłany w ramach tej próby, bez względu na wynik, ponieważ węzeł wyjściowy został w każdym przypadku użyty. Próba, która wciąż trwała, gdy odpowiedział inny węzeł wyjściowy, jest natychmiast przerywana, a ruch przesłany do tego momentu również jest naliczany.

Ruch standardowy również nie zależy od wyniku: w planie z limitem przepustowości ruch każdego żądania wlicza się do tego limitu. Żądanie odrzucone przez jeden z limitów Twojego planu nie nalicza żadnego ruchu.

Tunele używają tego samego słownictwa

Tunel przez port proxy kończy się jednym z tych samych wyników, więc jeden zestaw oznaczeń obejmuje oba produkty. Może wystąpić tylko pięć z siedmiu wyników, ponieważ dwa wyniki target wymagają, aby FourA odebrało odpowiedź celu, a odpowiedzią tunelu jest Twój własny zaszyfrowany ruch.

Wynik W przypadku tunelu oznacza to
success Tunel został otwarty i Twoje narzędzie go otrzymało.
client_error FourA nie otworzy tego tunelu: adres prywatny, zastrzeżony lub port, który nie jest obsługiwany.
rate_limit Osiągnięto jeden z limitów Twojego planu (jednocześnie otwarte tunele, otwarcia tuneli na minutę, standardowy ruch w danym okresie, brak dostępnego ruchu premium) lub sam port osiągnął limit przepustowości bądź limit tempa otwierania.
service_error FourA nie miało węzła wyjściowego dla Twojego żądania. Zazwyczaj jest to stan tymczasowy.
service_fail Cel nie był osiągalny przez żaden węzeł wyjściowy sprawdzony przez FourA: DNS, przekroczenie limitu czasu, odrzucenie połączenia.
application_error Nigdy nie występuje w przypadku tunelu.
application_fail Nigdy nie występuje w przypadku tunelu.

Odmowa zawiera również krótki powód, a panel wyświetla go w Twoich własnych kategoriach, a nie naszych. Opcja, której FourA nie może obsłużyć, zwraca 400 na samym połączeniu i nie zapisuje żadnego wiersza, więc w ogóle się tutaj nie pojawia.

Powód na ekranie Co zostało wyczerpane
port not in plan Twój plan nie obejmuje tego portu proxy
tunnels at once Wszystkie tunele dozwolone jednocześnie w Twoim planie były używane
openings per minute Limit otwarć tuneli na tę minutę w Twoim planie został wyczerpany
traffic used up Transfer dla Twojego planu w tym okresie został wyczerpany
premium not available Transfer premium nie jest obecnie dostępny w Twoim planie
port was full Sam port osiągnął limit pojemności lub limit tempa otwierania. Spróbuj ponownie za chwilę.
port not served FourA nie otwiera tuneli do tego portu
private address Adresy prywatne i zarezerwowane są nieosiągalne

Żaden element tunelu nie jest rozliczany w kredytach, ponieważ tunel nie ma pojedynczego requestu, do którego można by je naliczyć. Port zlicza zamiast tego bajty. Zobacz Jak rozliczany jest Twój plan.

Odczytywanie wyników w panelu

Każdy request wykonany przez Twój klucz API pojawia się na liście Activity z etykietą wyniku. Strony Metrics i Overview agregują to samo pole na wykresach pierścieniowych i osiach czasu.

Kiedy filtrujesz Activity według wyniku, możesz także skupić się na pojedynczym endpoincie (Auto, Single, Proxy Finder, Browser), aby sprawdzić, czy dany rodzaj błędu dotyczy tylko jednego z nich. Przełącz opcję Product na stronie na Proxy, a te same filtry wyników zastosują się do Twoich tuneli.

Heurystyka ponawiania prób

Wstępna polityka ponawiania prób oparta na wynikach:

Wynik Ponawianie bezpieczne? Kiedy
success nd. Masz już response.
application_error Czasami Sprawdź treść błędu celu. Niektóre są tymczasowe, większość nie. Jeśli ustawiono X-FourA-Check-Page, witryna wyświetliła stronę weryfikacji: wyślij URL do Auto, który traktuje stronę weryfikacji jako krok do przejścia, a nie jako ostateczną odpowiedź.
application_fail Czasami Jeśli cel nakłada rate limit, zwolnij tempo. Jeśli Cię blokuje, przełącz się na endpoint Proxy lub Browser.
client_error Nie Request zakończy się niepowodzeniem w ten sam sposób. Popraw dane wejściowe.
rate_limit Zależy Uwzględnij czas oczekiwania podany w response: Retry-After, retry_after_seconds lub retryAfter. Przy plan_limit_browser_daily wstrzymaj requesty do północy UTC; przy plan_limit_credits lub plan_limit_bandwidth wstrzymaj do resets_at; przy plan_limit_feature lub plan_limit_premium zmodyfikuj request.
service_error Tak Krótki backoff wykładniczy.
service_fail Tak Tak samo jak service_error.
  • Błędy API: Odpowiedzi błędów na poziomie HTTP
  • Port proxy: Kody statusu zwracane przy odrzuceniu połączenia przez tunel
  • Rate Limity: Co wyzwala rate_limit i dwie formy, w jakich jest zwracany
  • Metryki: Gdzie sprawdzić podział wyników
  • Dziennik aktywności: Historia wyników pojedynczych requestów
Aktualizacja: 11 listopada 2026