# Truy xuất thông minh (Tự động)

> URL: https://foura.ai/vi/docs/guides/smart-fetch
> Updated: 2026-11-13
> Index: https://foura.ai/llms.txt

Bạn cung cấp cho FourA một URL và một quy tắc `validate` xác định nội dung trang thực tế cần có. FourA xử lý phần còn lại: hệ thống đi qua từng bậc thang tối ưu chi phí, dừng lại ở bậc đầu tiên trả về phản hồi được quy tắc của bạn chấp nhận, và ghi nhớ phương án thành công cho từng host để lệnh gọi tiếp theo trên cùng trang web có chi phí thấp.

Hướng dẫn này giải thích cơ chế hoạt động bên dưới của auto, thời điểm nên sử dụng, và cách đọc phản hồi từ nó. Để xem tài liệu tham khảo tham số, hãy xem [API Endpoints](https://foura.ai/docs/api/endpoints#smart-fetch-auto).

## Ý tưởng

Hầu hết các thiết lập scraping bắt buộc bạn phải chọn engine ngay từ đầu. Single nhanh nhất, Proxy bổ sung tính năng xoay vòng IP, Browser xử lý JavaScript. Nếu bạn đoán sai, bạn sẽ lãng phí credit hoặc bị chặn.

Auto đảo ngược quy trình này. Bạn chỉ cần khai báo điều kiện thành công (`validate`), không phải phương thức. FourA sẽ thử từng bậc thang cho đến khi có một bậc thành công:

1. **Thăm dò chi phí thấp** (single, gửi trực tiếp từ mạng nội bộ của FourA)
2. **Browser**, gửi trực tiếp từ mạng nội bộ của FourA, có hỗ trợ JavaScript và bộ giải nếu trang web đưa ra thử thách
3. **Single qua proxy xoay vòng**
4. **Browser qua proxy** cho các mục tiêu khó nhất

Auto dừng lại ngay khi một bậc trả về phản hồi được quy tắc `validate` của bạn chấp nhận.

Có một bậc nằm ngoài thứ tự đó. Khi một điểm thoát truy cập được trang web nhưng trang web từ chối URL sâu mà bạn yêu cầu, auto sẽ lấy trang lối vào của trang web thông qua chính điểm thoát đó, lưu lại các cookie mà trang lối vào cung cấp, rồi yêu cầu lại URL của bạn kèm theo các cookie đó. Đó là bậc `warmup`. Bậc này chỉ chạy trên URL sâu hơn thư mục gốc của trang web, chỉ sau khi nỗ lực trực tiếp đã thất bại, và nó chỉ có thể bổ sung kết quả chứ không bao giờ làm giảm kết quả.

`forceProxy` mặc định là `true`, vì vậy bậc 1 và 2 được bỏ qua và mục tiêu không bao giờ thấy địa chỉ riêng của FourA. Hầu hết các lệnh gọi sau đó sẽ hoàn thành ở bậc 3, hoặc trên một session ấm được phát lại. Đặt `forceProxy: false` khi bạn biết mục tiêu xử lý địa chỉ sạch tốt hơn địa chỉ xoay vòng, và bậc 1 cùng 2 sẽ được kích hoạt trở lại.

## Dữ liệu bạn gửi

Yêu cầu tối thiểu là một URL kèm theo chuỗi con `validate`. Auto tự nhận diện các trang thử thách phổ biến, nhưng nếu không có `validate.data.accept`, nó không thể phân biệt trang thực tế với trang kiểm tra mà nó chưa biết, hoặc với trang tải thiếu nội dung của bạn, và nó có thể trả về một trong hai trường hợp đó dưới dạng thành công.

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

Các tùy chọn bổ sung (xem [tài liệu tham khảo endpoint](https://foura.ai/docs/api/endpoints#smart-fetch-auto) để biết đầy đủ chi tiết):

- `returnSession` (mặc định `true`): trả về `{ proxy, cookies, userAgent }` chiến thắng để bạn có thể phát lại nó.
- `forceProxy` (mặc định `true`): bỏ qua các bậc direct-egress. Chỉ đặt `false` nếu bạn biết trang web thân thiện với IP sạch hơn là xoay vòng IP đầu ra.
- `timeout_ms` (mặc định `120000`): tổng thời gian ngân sách cho toàn bộ lệnh gọi. Thang sẽ phân bổ nó qua các bậc.
- `ignoreProxies`: các proxy ID cần tránh trong mỗi lần thử phụ.
- `followRedirects` (mặc định `5`): số lần chuyển hướng tối đa trên các bậc chi phí thấp.
- `headers`: các header gửi đến trang web, dưới dạng các cặp `[name, value]`. Chúng được gửi trong các request Single và Proxy, bao gồm cả quá trình tìm kiếm exit đang hoạt động, và các bậc browser không gửi chúng. `Cookie` của riêng bạn sẽ đến trang web mà không bị thay đổi, và cookie của warm session chỉ được thêm vào cạnh nó với những tên mà bạn chưa gửi. Khi một warm session mang `userAgent`, nó sẽ thay thế `User-Agent` của bạn. Các header có điều kiện như `If-None-Match` và `If-Modified-Since` bị loại khỏi tìm kiếm exit trừ khi `validate.status.accept` của bạn liệt kê `304`.
- `exitClass`: `premium` cho phép Auto leo thang lên premium exit khi nhóm tiêu chuẩn không thể truy cập trang; `standard` quy định không bao giờ leo thang. Yêu cầu gói dịch vụ bao gồm premium exit. Xem [exitClass trên Smart Fetch](https://foura.ai/docs/api/endpoints#exitclass-on-smart-fetch).

## Dữ liệu bạn nhận lại

```json
{
  "status": 200,
  "data": "<!doctype html>...",
  "headers": [{"content-type": "text/html"}],
  "meta": {
    "rung": "cache",
    "solved": false,
    "attempts": 1,
    "credits": 2,
    "attemptsByEngine": {"single": 1, "proxy": 0, "browser": 0},
    "browserRequests": 0
  },
  "session": {
    "proxy": "A1B2C3",
    "cookies": [{"name": "session", "value": "abc", "domain": "example.com"}],
    "userAgent": "Mozilla/5.0..."
  }
}
```

Ba điều cần đọc:

- **`status` và `data`**: câu trả lời của mục tiêu. `data` là văn bản dù bậc thang nào phân phát trang, vì vậy một trang JSON trả về dưới dạng văn bản JSON và bạn tự phân tích cú pháp. `status` là HTTP status của mục tiêu, không phải status truyền tải của lệnh gọi đến FourA. Đối với các bậc thang single và proxy, `headers` là một mảng cho mỗi bước nhảy. Đối với các bậc thang browser, `headers` là một đối tượng phẳng.
- **`meta`**: trace ghi lại những gì thang đã thực hiện, xuất hiện trên mọi response khi thang đã bắt đầu chạy. `meta.rung` nêu tên bước đã phân phát response, `meta.attempts` đếm số lần thử lệnh gọi con, `meta.solved` gắn cờ liệu trang thử thách đã được hoàn thành hay chưa, và `meta.credits` là tổng chi tiêu cho lệnh gọi (cùng một con số với header `X-FourA-Credits`). `meta.attemptsByEngine` và `meta.browserRequests` cho biết lệnh gọi đã gửi những gì: xem [Những gì một lệnh gọi đã chi tiêu](#what-a-call-spent). Khi request chỉ định một `exitClass`, `meta.exitClass` sẽ cho biết loại exit nào đã phân phát.
- **`session`**: bộ ba `{ proxy, cookies, userAgent }` đã giải mã được mục tiêu. Sử dụng nó để phát lại tới cùng host qua `/api/single/` hoặc `/api/browser/`. Một trường có thể bị thiếu: session giành được bằng một lượt fetch proxy thông thường có `proxy` nhưng không có `userAgent`, và danh sách `cookies` của nó chỉ chứa cookie mà trang kiểm tra của trang web đặt trước khi trang web phân phát trang, vì vậy nó thường trống. Một câu trả lời từ lượt thăm dò trực tiếp giá rẻ chỉ mang theo `session` khi trang kiểm tra đó đặt cookie, và khi đó nó chỉ chứa duy nhất `cookies`. Status mà `validate.status.accept` của bạn liệt kê do một exit mang về (chẳng hạn như `404` của một trang đã bị xóa) sẽ không có bất kỳ `session` nào.

Auto trả lời bằng HTTP 200 bất cứ khi nào thang đã chạy, ngay cả khi mọi bậc thang đều thất bại. Đọc `status` và `error` trong body để biết điều gì đã xảy ra, không phải mã status truyền tải. Mã khác 200 từ `/api/auto/` có nghĩa là lệnh gọi chưa bao giờ đến được thang: 401 cho key không hợp lệ, 400 cho body không phải JSON hợp lệ, mục tiêu nằm trên mạng riêng tư, mục tiêu nằm trên chính API host của FourA, hoặc URL chứa dấu cách chưa được mã hóa bên trong, 403 với `X-FourA-Limit: plan_limit_premium` cho `exitClass: premium` trên gói không có exit cao cấp, và 502, 503 hoặc 504 khi dịch vụ không thể nhận lệnh gọi hoặc hết thời gian chờ. Auto không chiếm vị trí nào tại gateway, vì vậy các giới hạn dùng chung của nền tảng không từ chối chính lệnh gọi: khi một giới hạn từ chối lệnh gọi mà thang đã thực hiện, câu trả lời là HTTP 200 với `status: 429` hoặc `503` và `retryAfter` trong body. Một trường không qua được khâu xác thực cũng trả về dưới dạng HTTP 200, với `status: 400`. Giới hạn gói gặp phải bên trong thang cũng trả về dưới dạng HTTP 200, với thông báo từ chối trong body (xem [Khi giới hạn gói của bạn chạm tới thang](#when-your-plans-limits-meet-the-ladder)).

## Phát lại với Session

Sau khi auto trả về một session, bạn có thể chuyển thẳng sang Single hoặc Browser cho các trang tiếp theo trên cùng một host. Không cần leo thang mới, không cần thăm dò mới.

```python
import requests

API = "https://eu.api.foura.ai"
KEY = "YOUR_API_KEY"
H = {"X-API-Key": KEY, "Content-Type": "application/json"}

# 1) First call: let auto figure it out.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}},
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# 2) Follow-up pages: replay through single with the same proxy, UA and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    r = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, r["status"])
```

Thời gian duy trì session hoàn toàn phụ thuộc vào trang mục tiêu. Một số trang liên kết trạng thái clearance với cookie jar trong nhiều giờ; số khác lại luân phiên thay đổi sau mỗi vài phút. Nếu việc phát lại request bắt đầu gặp lại challenge, hãy gọi `/api/auto/` thêm một lần nữa để làm mới.

## Khi nào nên dùng Auto

| Dùng auto | Dùng thủ công single, proxy hoặc browser |
|----------|----------------------------------------|
| Bạn nhắm mục tiêu vào một trang mới và chưa biết trang đó yêu cầu những gì | Bạn đã biết chính xác engine nào hoạt động hiệu quả |
| Bạn muốn một lệnh gọi tự xử lý dự phòng proxy và browser cho mình | Bạn muốn toàn quyền kiểm soát cơ chế retry và timeout cho từng lệnh gọi |
| Bạn chấp nhận mất vài giây thăm dò ở lệnh gọi đầu tiên | Độ trễ của lệnh gọi đầu tiên quan trọng hơn việc tự động phát hiện |
| Bạn muốn có một session đã học để phát lại với chi phí thấp | Bạn đang tối ưu hóa một vòng lặp chặt chẽ trên một mục tiêu đã biết rõ |

Auto không phải lúc nào cũng là lựa chọn tiết kiệm nhất. Nếu bạn biết mục tiêu hoạt động tốt với `single` + `unblocker`, việc gọi trực tiếp Single chỉ tốn 2 credit với độ trễ dự đoán được. Chế độ Auto trên cùng mục tiêu đó sẽ tiêu tốn bất kỳ chi phí nào mà chu trình bậc thang của nó sử dụng, có thể cao hơn nếu trang web yêu cầu leo thang giải pháp.

## Validate cho Auto biết thế nào là "Thành công"

Tham số quan trọng nhất chính là `validate`. Nếu không có tham số này, auto chỉ từ chối các trang challenge mà nó nhận diện được, vì vậy một trang kiểm tra lạ hoặc một khung trang rỗng trả về mã HTTP 200 sẽ bị coi là nội dung hợp lệ.

Hãy sử dụng `validate.data.accept` với một chuỗi con mà chỉ trang thực tế mới chứa:

```json
{
  "validate": {
    "data": {
      "accept": ["sku-42-add-to-cart", "Customer reviews"]
    }
  }
}
```

Đối với JSON API, hãy chấp nhận tên trường mà bạn mong đợi:

```json
{
  "validate": {
    "data": { "accept": ["\"products\":["] },
    "status": { "accept": [200] }
  }
}
```

Đối với các trang web trả về mã không phải 200 một cách hợp lệ (giới hạn quốc gia bạn muốn bỏ qua, `404` hoặc `410` của một trang đã bị xóa), hãy cho phép chúng thông qua `validate.status.accept`:

```json
{
  "validate": {
    "status": { "accept": [200, 451] }
  }
}
```

Auto sẽ trả về trạng thái bạn liệt kê trong `validate.status.accept` ngay khi một exit nhận được nó và thỏa mãn phần còn lại trong quy tắc của bạn. Bốn trạng thái sau là ngoại lệ: `202`, `403`, `429` và `503`. Auto hiểu các mã này là trang web đang kiểm tra người gửi request, vì vậy một exit trả về các mã đó sẽ không làm dừng quá trình tìm kiếm, và hệ thống sẽ tiếp tục thử các nấc thang tiếp theo.

Nếu không có `validate`, auto sẽ quay về cơ chế mặc định "HTTP 200 = thành công" cho mọi trang không được nhận diện là challenge, do đó nó sẽ bỏ qua trang kiểm tra lạ mà trang web trả về kèm mã 200.

## Đọc `meta.rung` để hiểu chuyện gì đã xảy ra

`meta.rung` là tín hiệu debug hữu ích nhất. Các giá trị:

- `probe`: xử lý thành công bằng request trực tiếp với chi phí thấp. Đây là phương án tiết kiệm nhất.
- `proxy`: cần xoay vòng proxy để vượt qua.
- `browser`: cần render toàn bộ trình duyệt, có thể đi kèm giải challenge.
- `cache`: phát lại warm session từ một lệnh gọi auto trước đó. Phương án tiết kiệm nhất cho các lệnh gọi lặp lại.
- `warmup`: trang web hiển thị trang đích ban đầu nhưng chặn URL sâu bên trong, vì vậy auto đã tải trang đích trước, giữ lại cookie được cấp và gửi request lại bằng các cookie đó. Session được lưu từ nấc này không bị ràng buộc vào một exit duy nhất, giúp các lệnh gọi tiếp theo rơi vào các nấc có chi phí thấp.
- `fail`: không có nấc nào tạo ra response được quy tắc của bạn chấp nhận.

`meta.solved: true` nghĩa là đã gặp và hoàn thành trang challenge trong quá trình gọi. `meta.attempts` là số lần thử sub-call trước khi thành công. Để biết chi tiết cụ thể, hãy đọc trường `defense` do các nấc single và proxy trả về: xem [Kiểm tra trang web](https://foura.ai/docs/api/site-checks).

Nếu một trang web liên tục dừng ở `browser` trong khi bạn mong đợi `probe`, hãy xem xét liệu quy tắc `validate` chặt chẽ hơn (hoặc ít nghiêm ngặt hơn) có giúp một nấc rẻ hơn vượt qua hay không. Lưu ý rằng `forceProxy` mặc định là `true`, vì vậy bước kiểm tra egress trực tiếp sẽ bị bỏ qua trừ khi bạn tắt tùy chọn này.

## Chi phí tiêu hao của một lệnh gọi

`meta.attemptsByEngine` đếm các request mà lệnh gọi đã gửi đến từng engine, tương đương với các request mà bảng Auto attempts hiển thị trên [Overview](https://foura.ai/docs/dashboard/overview) của bạn. `meta.browserRequests` đếm những request đã chiếm một slot trong hạn mức trình duyệt hàng ngày của bạn.

```json
"meta": {
  "rung": "browser",
  "solved": true,
  "attempts": 7,
  "credits": 47,
  "attemptsByEngine": {"single": 1, "proxy": 4, "browser": 3},
  "browserRequests": 2
}
```

| Trường | Loại | Mô tả |
|-------|------|-------------|
| `meta.attemptsByEngine` | object | Các request gửi tới `single`, `proxy` và `browser`. Request trình duyệt bị gói của bạn từ chối vẫn được tính ở đây, vì nó đã được gửi đi. |
| `meta.browserRequests` | number | Các request trình duyệt đã chiếm một vị trí trong hạn mức hàng ngày của bạn. Request trình duyệt bị gói của bạn từ chối sẽ không chiếm hạn mức. |

`meta.attempts` đếm các bước của bậc thang, vì vậy nó không phải lúc nào cũng bằng tổng của `meta.attemptsByEngine`. Một bước có thể gửi một Single request rồi sau đó là một Proxy request, và một bước có trình duyệt đã đóng trong ngày sẽ không gửi gì cả.

Số lượng tích lũy trong ngày của bạn được chuyển trong các header `X-FourA-Browser-Used-Today` và `X-FourA-Browser-Limit-Per-Day`: xem [Response Headers](https://foura.ai/docs/api/response-headers).

## Lỗi và các trường hợp biên

Khi auto thất bại, response mang `status` (thường là status của bậc thang thất bại gần nhất) và một chuỗi `error`:

```json
{
  "status": 502,
  "error": "could not find a working exit for the target",
  "attempts": 7,
  "attemptReport": {
    "total": 7,
    "noResponse": 5,
    "defense": 2,
    "contentRejected": 0,
    "statusRejected": 0,
    "other": 0,
    "vendors": ["datadome"],
    "summary": "7 attempt(s): 5 got no answer from the site; 2 refused by the site (datadome)"
  },
  "meta": {
    "rung": "fail",
    "solved": false,
    "attempts": 7,
    "credits": 47,
    "attemptsByEngine": {"single": 0, "proxy": 4, "browser": 3},
    "browserRequests": 3
  }
}
```

`status` là phản hồi của trang web trong lần thử cuối cùng mà Auto từ chối, chẳng hạn như `403`. Khi không có lần thử nào nhận được phản hồi từ trang web, lỗi thường là `502` hoặc `504`, và `error` cho biết không tìm thấy exit nào hoạt động hay đã hết ngân sách `timeout_ms`. `status: 0` chỉ có nghĩa là host name của mục tiêu không phân giải được, và câu trả lời đó không có `meta` vì ladder chưa từng bắt đầu.

Auto cũng dừng sớm khi trình duyệt của nó liên tục gặp phải bước kiểm tra không thể hoàn thành. Sau khi hai exit từ chối trình duyệt theo cách đó và việc tìm kiếm một exit có plain fetch vượt qua quy tắc `validate` của bạn không có kết quả, hoặc sau ba exit như vậy, lệnh gọi sẽ kết thúc. `status` chứa phản hồi cuối cùng của trang web và `error` bắt đầu bằng `the browser was refused by`, theo sau là tên của hệ thống kiểm tra.

Auto cũng dừng lại khi chính trang web báo rằng trang không tồn tại. Khi hai exit trả về cùng một mã `404` hoặc `410` và quy tắc của bạn không chấp nhận nó, lệnh gọi kết thúc với `status` đó, và `error` bắt đầu bằng `the site answered`. Nếu một trang đã bị xóa là kết quả bạn mong muốn, hãy liệt kê `404` hoặc `410` trong `validate.status.accept`: Khi đó Auto sẽ trả về kết quả là đã phân phối ngay khi có một exit mang nó về.

Sau bốn lệnh gọi Auto liên tiếp bằng API key của bạn kết thúc mà không lấy được trang do trang web liên tục từ chối, Auto sẽ ngừng thử trang web đó cho khóa của bạn trong 120 giây. Một lệnh gọi gửi tới đó trong khoảng thời gian này sẽ phản hồi ngay lập tức với `status: 503`, `error: "target temporarily unservable, retry later"` cùng `retryAfter` tính bằng giây, và hoàn toàn miễn phí. Giới hạn này được tính theo từng API key: các khóa khác gọi cùng trang web sẽ không bị ảnh hưởng, và bất kỳ lệnh gọi nào lấy được trang thành công sẽ đặt lại bộ đếm. Lệnh gọi với `exitClass: premium` không bị chặn bởi cơ chế này.

Kiểm tra `attemptReport`, `meta.attemptsByEngine` và `meta.credits` để xem ngân sách đã được dùng vào đâu. Nếu `meta.attempts` cao và `meta.rung` là `fail` sau bậc trình duyệt, mục tiêu có thể cần `timeout_ms` dài hơn, quy tắc `validate` nghiêm ngặt hơn, hoặc đơn giản là hiện không thể truy cập qua rotating proxies.

### Lý do lệnh gọi Auto thất bại

Mỗi câu trả lời thất bại từ một ladder đã chạy đều mang một `attemptReport`. Nó đếm các engine request trả về mà không có trang, mỗi request một lần, theo đúng trường hợp gặp phải.

| Trường | Kiểu | Mô tả |
|-------|------|-------------|
| `total` | integer | Số request trả về mà không có trang. Tối đa bằng tổng của `meta.attemptsByEngine`, vì request trình duyệt bị gói của bạn từ chối sẽ không bao giờ thử gửi đến mục tiêu. |
| `noResponse` | integer | Không nhận được phản hồi từ trang web |
| `defense` | integer | Trang web đã từ chối request: phát hiện kiểm tra bot, trang là challenge, hoặc trang web phản hồi 401, 403, 429 hoặc 503 |
| `contentRejected` | integer | Trang đã được tải và chỉ có quy tắc `validate` của bạn từ chối nó |
| `statusRejected` | integer | Trang web phản hồi với trạng thái mà request của bạn không chấp nhận, chẳng hạn như 404 cho trang đã bị xóa |
| `other` | integer | Thất bại vì lý do khác, chẳng hạn như lỗi máy chủ |
| `vendors` | string[] | Các nhà cung cấp kiểm tra bot được nhận diện trong các lần từ chối mà lệnh gọi gặp phải |
| `summary` | string | Một câu được tạo từ các số đếm, an toàn để ghi log. Trường này nêu trạng thái HTTP mà trang web phản hồi khi không nhận diện được nhà cung cấp nào, đồng thời thông báo khi hạn mức trình duyệt hàng ngày của bạn đã hết, khiến không thể mở trình duyệt. |

Các trường này khớp với báo cáo trên một lệnh gọi [Proxy thất bại](https://foura.ai/docs/troubleshooting/proxy-attempt-report), ngoại trừ `profilesTried`. Có hai điểm khác biệt. Proxy đếm từng exit mà nó đã thử, tối đa theo `maxTries` bạn đặt, còn Auto đếm các request của chính nó. Auto cũng đọc trang và trạng thái của trang, vì vậy một lần từ chối sẽ được tính vào `defense` ngay cả khi không nhận diện được nhà cung cấp nào. Số đếm trong `contentRejected` là phần bạn có thể tự xử lý: trang đã trả về nhưng quy tắc của bạn không khớp với nó.

### Khi giới hạn của gói chạm mức các bậc thang

Các lệnh gọi con của Auto là các request Single, Proxy và Browser thông thường dưới khóa của bạn, do đó [giới hạn gói](https://foura.ai/docs/api/rate-limits) của bạn áp dụng cho chúng. Bậc thang đọc mã `X-FourA-Limit` khi bị từ chối và xử lý hai loại này khác nhau.

**Một bậc bị đóng vẫn để phần còn lại của bậc thang hoạt động được.** `plan_limit_browser_daily` (các request Browser trong ngày của bạn đã hết) và `plan_limit_concurrency` (endpoint đó đã chạy số lượng request tối đa mà gói cho phép) sẽ đóng một bậc. Auto tiếp tục chạy các bậc khác, vì vậy bạn vẫn nhận được trang bất cứ khi nào một exit xoay vòng hoặc một session đang hoạt động phân phối nội dung, và các exit đã thử không bị tính lỗi cho sự từ chối bắt nguồn từ chính gói của bạn. Không có gì bị cấm và không có session nào bị hủy bỏ.

**Một tài khoản hết hạn mức sẽ dừng toàn bộ bậc thang.** `plan_limit_credits`, `plan_limit_bandwidth`, `plan_limit_rate`, `plan_limit_feature`, và `plan_limit_premium` không thể được giải quyết bằng bậc khác, vì vậy Auto trả về ngay lập tức thay vì tiêu tốn thêm credit của bạn để kiểm chứng. Phản hồi từ chối trả về trong body cùng trạng thái của lệnh gọi con và trường `reason` tương tự mà các endpoint trực tiếp sử dụng:

```json
{
  "status": 429,
  "error": "Credit limit reached: 300,000 of 300,000 credits used this billing period. Upgrade your plan or wait for the reset.",
  "reason": "plan_limit_credits",
  "documentation": "https://foura.ai/prices",
  "used": 300000,
  "hard_stop": 300000,
  "retry_after_seconds": 86400,
  "resets_at": "2026-10-01T00:00:00.000Z",
  "meta": { "rung": "fail", "solved": false, "attempts": 1, "credits": 0 }
}
```

Toàn bộ body từ chối từ sub-call được chuyển tiếp đầy đủ, kèm theo `status`, `attemptReport` và `meta`. Đọc `status` từ body chứ không phải từ status của tầng transport: auto vẫn trả về HTTP 200 ở đây, vì thang phân cấp đã chạy. Lỗi từ chối `plan_limit_feature` hoặc `plan_limit_premium` cũng trả về tương tự cùng với `status: 403`. Một sub-call bị từ chối sẽ không tốn chi phí, do đó `meta.credits` chỉ tính các nấc thang đã tiếp cận được target.

Một lệnh gọi auto có thể chiếm giữ nhiều slot trong khi thang phân cấp leo bậc, vì vậy một batch các lệnh gọi auto chạy song song sẽ chạm trần concurrency với số lượng lệnh gọi ít hơn bạn dự kiến. [Chạy Request Song Song](https://foura.ai/docs/how-to/run-requests-in-parallel) hướng dẫn cách định cỡ batch.

## Auto Không Thực Hiện Những Gì

- Không thay đổi các giới hạn pháp lý. Nếu một trang web từ chối mọi exit node mà FourA có thể tiếp cận, auto sẽ trả về kết quả từ chối đó.
- Không cache nội dung. Mỗi lệnh gọi vẫn gửi trực tiếp đến target. "Phiên hoạt động ấm" đại diện cho proxy và cookie, không phải response.
- Hiển thị dưới dạng một hàng duy nhất trong [Activity Log](https://foura.ai/docs/dashboard/activity-log), dưới request id bạn đã nhận, kèm tổng số credit của các sub-call. Mở rộng mục này để xem các sub-call Single / Proxy / Browser mà auto đã thay mặt bạn thực hiện dưới dạng các lần thử, mỗi lần có kết quả riêng. Chúng được tính vào hạn ngạch Single, Proxy và Browser của bạn, không bao giờ tính vào số lượng request hay tỷ lệ thành công.

## Liên Quan

- [API Endpoints](https://foura.ai/docs/api/endpoints#smart-fetch-auto): Tài liệu tham khảo đầy đủ về tham số
- [Chọn Endpoint Phù Hợp](https://foura.ai/docs/guides/choosing-task-type): Khi nào nên chọn auto so với single, proxy, hoặc browser
- [Kết Quả Request](https://foura.ai/docs/api/outcomes): Những kết quả nào bị tính phí
- [Các Trang Web Được Bảo Vệ](https://foura.ai/docs/guides/protected-sites): FourA xử lý thế nào trên các trang web kiểm tra danh tính người yêu cầu
- [Kiểm Tra Trang Web](https://foura.ai/docs/api/site-checks): Trường `defense` phía sau `meta.solved`
- [MCP Recipes](https://foura.ai/docs/mcp/recipes): Các mô hình tương tự dưới dạng MCP tool call
- [Rate Limits](https://foura.ai/docs/api/rate-limits): Các giới hạn của gói dùng để đối chiếu các sub-call của auto
