# Wyniki żądań

> URL: https://foura.ai/pl/docs/api/outcomes
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

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](#billing-implications).

## 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](#tunnels-use-the-same-vocabulary) 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](https://updates.foura.ai/status), 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:

```json
{
  "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](https://foura.ai/docs/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.

```bash
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`](https://foura.ai/docs/api/response-headers) 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](https://foura.ai/docs/api/endpoints#exitclass), 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](https://foura.ai/docs/api/proxy-port) 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](https://foura.ai/docs/guides/plans-and-metering).

## Odczytywanie wyników w panelu

Każdy request wykonany przez Twój klucz API pojawia się na liście [Activity](https://foura.ai/docs/dashboard/activity-log) z etykietą wyniku. Strony [Metrics](https://foura.ai/docs/dashboard/metrics) i [Overview](https://foura.ai/docs/dashboard/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`. |

## Powiązane

- [Błędy API](https://foura.ai/docs/api/errors): Odpowiedzi błędów na poziomie HTTP
- [Port proxy](https://foura.ai/docs/api/proxy-port): Kody statusu zwracane przy odrzuceniu połączenia przez tunel
- [Rate Limity](https://foura.ai/docs/api/rate-limits): Co wyzwala `rate_limit` i dwie formy, w jakich jest zwracany
- [Metryki](https://foura.ai/docs/dashboard/metrics): Gdzie sprawdzić podział wyników
- [Dziennik aktywności](https://foura.ai/docs/dashboard/activity-log): Historia wyników pojedynczych requestów
