# Kết quả Request

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

Mỗi request gửi đến FourA API đều được phân loại vào chính xác một outcome, và mỗi tunnel qua cổng proxy cũng vậy. Outcome được tính toán một lần khi kết thúc lệnh gọi và được ghi nhận cho thông tin xác thực đã thực hiện nó. Bảng điều khiển, luồng hoạt động và phần thanh toán của bạn đều đọc cùng một trường này.

Chỉ `success` mới tiêu tốn credit. Lưu lượng truy cập cao cấp được tính riêng biệt với credit và không phụ thuộc vào outcome: xem [Ý nghĩa thanh toán](#billing-implications).

## Bảy outcome

Dưới đây là bảy kết quả mà một request có thể nhận. Một tunnel sử dụng năm trong số đó: xem [Tunnel sử dụng cùng hệ thống thuật ngữ](#tunnels-use-the-same-vocabulary) bên dưới.

| Outcome | Tầng | Ý nghĩa |
|---------|-------|--------------|
| `success` | k/d | Phản hồi hợp lệ đã được gửi đến. Tính vào hạn mức thanh toán của bạn. |
| `application_error` | target | Mục tiêu trả về HTTP 200, nhưng phần thân chứa trường lỗi, hoặc phần thân là trang kiểm tra bot hoặc trang từ chối mà FourA nhận diện được. |
| `application_fail` | target | Mục tiêu trả về trạng thái khác 200 mà các quy tắc `validate` của bạn không chấp nhận hoặc bạn không gửi `validate`, hoặc hoàn toàn không có phản hồi, bao gồm trường hợp tên host mục tiêu không thể phân giải. |
| `client_error` | caller | Request của bạn bị từ chối trước khi rời khỏi FourA. Tham số không hợp lệ, giá trị proxy sai định dạng, URL bị chặn bởi bảo vệ SSRF. |
| `rate_limit` | FourA | Request bị từ chối trước khi chạy: do một trong các giới hạn gói cước của bạn (403 đối với endpoint hoặc tham số không có trong gói, 429 đối với hạn mức đã dùng hết), hoặc do hạn mức RPM hoặc concurrency dùng chung của nền tảng. |
| `service_error` | FourA | Engine phản hồi bằng lỗi server, hoặc phần thân không phải là JSON hợp lệ. |
| `service_fail` | FourA | Mạng nội bộ của FourA gặp sự cố: engine không phản hồi kịp thời hoặc kết nối bị ngắt, hoặc bạn đã ngắt kết nối. |

Cột tầng cho bạn biết bên nào chịu trách nhiệm:

- Các outcome **target** liên quan đến trang web bạn đã gọi. Request của bạn đến FourA bình thường, và FourA kết nối đến mục tiêu bình thường. Chính mục tiêu đã trả về lỗi.
- Các outcome **caller** nghĩa là request của bạn không hợp lệ ngay từ đầu. Hãy sửa lại cấu trúc request.
- Các outcome **FourA** là lỗi từ phía chúng tôi. Hãy thử lại và kiểm tra [trang trạng thái](https://updates.foura.ai/status) nếu lỗi vẫn tiếp diễn.

Trang mục tiêu trả về `403` được tính là `application_fail`, không phải `client_error`. Lệnh gọi của bạn có cấu trúc hoàn toàn hợp lệ. Chỉ là trang web đó từ chối tiếp nhận.

## Dấu hiệu nhận biết lệnh gọi thất bại

Lệnh gọi đã đến FourA và được thực thi sẽ trả về HTTP 200 bất kể điều gì xảy ra sau đó. Chỉ trường hợp bị từ chối trước khi fetch (400, 401, 403, 413, 429) hoặc sự cố từ phía FourA (5xx) mới sử dụng mã trạng thái HTTP khác. Vì vậy, outcome được đọc từ body, không phải từ mã trạng thái truyền tải.

| Body | Chuyện gì đã xảy ra | Kết quả |
|------|---------------|---------|
| `status: 200`, `headers`, `data`, không có `error` | Trang đã được phân phối thành công. | `success` |
| `status` khác 200, `headers`, `data`, không có `error` | Máy chủ đích đã phản hồi và bạn không gửi `validate`. Phản hồi nằm trong `data`. | `application_fail` |
| `status` khác 200, `headers`, `data` và `error` | Máy chủ đích đã phản hồi và các quy tắc `validate` của bạn đã từ chối, ví dụ `Status 404 is not in accept list 200`. | `application_fail` |
| `status: 200`, `headers`, `data` và `error` | Máy chủ đích phản hồi HTTP 200 và các quy tắc `validate` của bạn đã từ chối, ví dụ `Data not in accept list ["product"]`. | `application_error` |
| Chỉ có `error` và `total_time`, không có `status`, không có `data` | Máy chủ đích không phản hồi HTTP: đã đạt giới hạn chuyển hướng (`Number of redirects hit maximum amount`), hết thời gian kết nối hoặc đọc, kết nối bị đặt lại, hoặc phản hồi trống. Văn bản là lý do từ chính engine. | `application_fail` |
| `status: 0` và `error`, không có gì khác | Không thể phân giải tên máy chủ: `could not resolve <host>: <reason>`. Không có engine nào chạy, và ở chế độ Auto không có `meta`. Thử lại sẽ không thay đổi kết quả cho đến khi DNS thay đổi. | `application_fail` |

Vòng lặp chuyển hướng, theo góc nhìn của hàng thứ năm:

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

Trên `POST /api/proxy/`, một lệnh gọi hết số lần thử sẽ mang `error: Download maxTry limit reached` cùng một `attemptReport` chứa số lần đếm (xem [API Errors](https://foura.ai/docs/api/errors)). Trên `POST /api/auto/`, một ladder đã chạy và thất bại sẽ mang `status`, `error`, `attempts`, một `attemptReport` chứa các nguyên nhân, và `meta.rung` được đặt thành `fail`.

`X-FourA-Credits` báo cáo công việc đã thực hiện, ngay cả khi thất bại. Hệ thống thanh toán chỉ tính `success`, do đó không có cấu trúc thất bại nào ở trên bị tính phí.

## Thành Công Phụ Thuộc Vào `validate`

Nếu không có `validate`, API chỉ đánh dấu một request là `success` khi mục tiêu trả về HTTP 200.

Khi có `validate`, kết quả thành công sẽ tuân theo các quy tắc bạn đã khai báo. Nếu bạn thông báo cho API rằng 200 và 403 đều được chấp nhận cho một request nhất định, mã 403 trả về sẽ được tính là `success`. Phần body vẫn được gửi đến bạn mà không thay đổi.

```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] }
    }
  }'
```

Trong lệnh gọi này, phản hồi 403 được tính là `success` và được tính phí như một request. Phản hồi 500 được tính là `application_fail` và không bị tính phí.

Logic tương tự áp dụng cho `validate.headers` và `validate.data`. Bất kỳ phản hồi nào mà engine chấp nhận theo các quy tắc của bạn đều được trả về dưới dạng `success` bất kể trạng thái HTTP nào.

Có một câu trả lời không bao giờ là `success`, dù có hoặc không có `validate`: một phản hồi HTTP 200 có phần body là trang kiểm tra bot mà FourA nhận diện, chẳng hạn như tác vụ xác minh hình ảnh hoặc trang chỉ yêu cầu trình duyệt chạy JavaScript, hoặc trang từ chối mà một trang web phân phát kèm HTTP 200. Request đó là `application_error` và không bị tính phí. Phần body vẫn được gửi đến bạn mà không thay đổi, và header [`X-FourA-Check-Page`](https://foura.ai/docs/api/response-headers) sẽ nêu rõ tên trang.

## Tác động đến tính phí

| Kết quả | Tính phí | Tính vào hạn mức |
|---------|----------|--------------------|
| `success` | Có | Có |
| `application_error` | Không | Không |
| `application_fail` | Không | Không |
| `client_error` | Không | Không |
| `rate_limit` | Không | Không |
| `service_error` | Không | Không |
| `service_fail` | Không | Không |

Chỉ những request phân phát thành công dữ liệu bạn yêu cầu mới bị tính phí. Lỗi từ phía FourA, phía mục tiêu hoặc từ chính phía bạn đều hoàn toàn miễn phí.

Bảng này đề cập đến credit. Lưu lượng premium được tính riêng biệt với credit: một request đã thử một [exit premium](https://foura.ai/docs/api/endpoints#exitclass) sẽ tính lưu lượng mà lần thử đó đã truyền tải, bất kể kết quả ra sao, vì exit đó đã được sử dụng trong mọi trường hợp. Một lần thử vẫn đang chạy khi một exit khác đã phản hồi sẽ bị dừng ngay lập tức, và lưu lượng nó đã truyền tải cho đến thời điểm đó cũng được tính.

Lưu lượng standard cũng không phụ thuộc vào kết quả: trên gói có giới hạn băng thông, lưu lượng của mọi request đều được tính vào giới hạn đó. Một request bị từ chối bởi một trong các giới hạn trong gói của bạn sẽ không bị tính lưu lượng.

## Đường hầm sử dụng cùng hệ thống thuật ngữ

Một đường hầm qua [cổng proxy](https://foura.ai/docs/api/proxy-port) cũng kết thúc bằng một trong các kết quả này, do đó một bộ nhãn bao hàm cả hai sản phẩm. Chỉ có năm trong số bảy kết quả có thể xảy ra, vì hai kết quả `target` yêu cầu FourA phải nhìn thấy câu trả lời của mục tiêu, trong khi câu trả lời của một đường hầm lại là lưu lượng mã hóa của chính bạn.

| Kết quả | Đối với đường hầm, điều này có nghĩa là |
|---------|-------------------------|
| `success` | Đường hầm đã mở và công cụ của bạn đã nhận được nó. |
| `client_error` | FourA sẽ không mở đường hầm đó: một địa chỉ riêng tư hoặc dành riêng, hoặc một cổng mà hệ thống không hỗ trợ. |
| `rate_limit` | Đã đạt đến một trong các giới hạn trong gói của bạn (số đường hầm mở cùng lúc, số lần mở đường hầm mỗi phút, lưu lượng standard trong kỳ, lưu lượng premium mà bạn không có), hoặc chính cổng đó đã đạt hết công suất hoặc tốc độ mở. |
| `service_error` | FourA không có exit khả dụng cho nội dung bạn yêu cầu. Thường chỉ là tạm thời. |
| `service_fail` | Không thể tiếp cận mục tiêu thông qua bất kỳ exit nào FourA đã thử: lỗi DNS, timeout, kết nối bị từ chối. |
| `application_error` | Không bao giờ xảy ra trên đường hầm. |
| `application_fail` | Không bao giờ xảy ra trên đường hầm. |

Một lần từ chối cũng đi kèm lý do ngắn gọn, và dashboard hiển thị lý do đó theo thuật ngữ của bạn thay vì của chúng tôi. Tùy chọn mà FourA không thể đáp ứng sẽ được phản hồi `400` ngay trên chính kết nối và không ghi dòng nào, do đó nó hoàn toàn không xuất hiện tại đây.

| Lý do trên màn hình | Giới hạn bị chạm |
|------------------|--------------|
| port not in plan | Gói cước của bạn không bao gồm proxy port này |
| tunnels at once | Mọi tunnel mà gói của bạn cho phép cùng lúc đều đang được sử dụng |
| openings per minute | Số lượt mở tunnel trong phút này của gói cước đã hết |
| traffic used up | Lưu lượng traffic trong chu kỳ này của gói cước đã hết |
| premium not available | Traffic cao cấp hiện không khả dụng trên gói của bạn |
| port was full | Bản thân port đã đạt giới hạn dung lượng hoặc tốc độ mở. Hãy thử lại sau giây lát. |
| port not served | FourA không mở tunnel tới port đó |
| private address | Không thể tiếp cận các địa chỉ riêng tư và dành riêng |

Không có khoản phí nào của tunnel được tính bằng credit, vì tunnel không có request nào để trừ phí. Thay vào đó, port sẽ đo lường theo byte. Xem [Cách Gói Cước Của Bạn Được Đo Lường](https://foura.ai/docs/guides/plans-and-metering).

## Đọc Kết Quả trong Dashboard

Mọi request mà API key của bạn thực hiện đều xuất hiện trên bảng tin [Activity](https://foura.ai/docs/dashboard/activity-log) cùng với nhãn kết quả tương ứng. Các trang [Metrics](https://foura.ai/docs/dashboard/metrics) và [Overview](https://foura.ai/docs/dashboard/overview) tổng hợp trường này cho biểu đồ donut và timeline.

Khi bạn lọc Activity theo kết quả, bạn cũng có thể tập trung vào một endpoint duy nhất (Auto, Single, Proxy Finder, Browser) để xem liệu một loại lỗi có xảy ra riêng ở endpoint đó hay không. Chuyển mục **Product** của trang sang Proxy và các nhãn kết quả tương tự sẽ lọc tunnel của bạn.

## Heuristic Thử Lại

Chính sách thử lại cơ bản dựa trên kết quả:

| Kết quả | Có an toàn để thử lại? | Khi nào |
|---------|-------------|------|
| `success` | k/d | Bạn đã có response. |
| `application_error` | Đôi khi | Đọc error body từ mục tiêu. Một số là tạm thời, phần lớn thì không. Nếu `X-FourA-Check-Page` được thiết lập, trang web đã trả về trang kiểm tra: hãy gửi URL tới Auto, nơi xử lý trang kiểm tra như một bước cần vượt qua chứ không phải câu trả lời. |
| `application_fail` | Đôi khi | Nếu trang mục tiêu đang giới hạn rate limit của bạn, hãy giảm tốc độ. Nếu trang đang chặn bạn, hãy chuyển sang endpoint Proxy hoặc Browser. |
| `client_error` | Không | Request sẽ thất bại tiếp theo cùng một cách. Hãy sửa dữ liệu đầu vào. |
| `rate_limit` | Tùy trường hợp | Tuân thủ thời gian chờ mà response cung cấp: `Retry-After`, `retry_after_seconds`, hoặc `retryAfter`. Với `plan_limit_browser_daily`, tạm dừng cho đến nửa đêm UTC; với `plan_limit_credits` hoặc `plan_limit_bandwidth`, tạm dừng cho đến `resets_at`; với `plan_limit_feature` hoặc `plan_limit_premium`, hãy thay đổi request. |
| `service_error` | Có | Exponential backoff ngắn. |
| `service_fail` | Có | Tương tự như `service_error`. |

## Liên quan

- [Lỗi API](https://foura.ai/docs/api/errors): Các response lỗi ở cấp độ HTTP
- [Cổng Proxy](https://foura.ai/docs/api/proxy-port): Các mã trạng thái trả về khi tunnel từ chối
- [Rate Limit](https://foura.ai/docs/api/rate-limits): Những nguyên nhân kích hoạt `rate_limit`, và hai định dạng phản hồi của nó
- [Số liệu (Metrics)](https://foura.ai/docs/dashboard/metrics): Nơi bạn xem kết quả được phân tích chi tiết
- [Nhật ký hoạt động](https://foura.ai/docs/dashboard/activity-log): Lịch sử kết quả của từng request
