# Chọn endpoint phù hợp

> URL: https://foura.ai/vi/docs/guides/choosing-task-type
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

FourA cung cấp bốn endpoint request, mỗi endpoint được tối ưu hóa cho một trường hợp riêng biệt. Việc chọn đúng endpoint giúp tiết kiệm thời gian, giảm chi phí và nâng cao tỷ lệ thành công.

## Hướng dẫn quyết định nhanh

**Sử dụng auto endpoint khi:**
- Bạn đang nhắm mục tiêu vào một trang web mới và chưa biết rõ trang web đó yêu cầu những gì
- Bạn muốn một lệnh gọi duy nhất tự động xử lý fallback qua proxy xoay vòng và trình duyệt
- Bạn muốn có một session để phát lại với chi phí thấp trong lệnh gọi tiếp theo đến cùng host

**Sử dụng single endpoint khi:**
- Trang được kết xuất phía server (không cần JavaScript)
- Bạn cần tốc độ tối đa (thường dưới 1 giây)
- Bạn đang gọi API hoặc các trang HTML tĩnh từ một host mà bạn đã biết chắc chắn hoạt động

**Sử dụng browser endpoint khi:**
- Trang phụ thuộc vào JavaScript để kết xuất nội dung
- Nội dung được tải sau lần tải trang ban đầu
- Bạn cần DOM đã được kết xuất đầy đủ

**Sử dụng proxy endpoint khi:**
- Trang web mục tiêu chủ động chặn các request
- Bạn cần xoay vòng qua nhiều địa chỉ IP khác nhau
- Các lần thử trước đó trả về mã 403 hoặc trang xác minh

## So sánh các endpoint

### Auto (`POST /api/auto/`)

Endpoint smart-fetch. Bạn truyền một URL và (lý tưởng nhất là) một quy tắc `validate`, FourA sẽ duyệt qua các bậc thang tối ưu chi phí: thử proxy xoay vòng trước, sau đó thử trình duyệt đầy đủ qua proxy. Thiết lập `forceProxy: false`, một lượt thăm dò trực tiếp chi phí thấp và một lượt kết xuất trình duyệt trực tiếp sẽ chạy trước cả hai bước trên. Bậc đầu tiên trả về response khớp với `validate` của bạn sẽ được chọn. Với các lệnh gọi lặp lại đến cùng host, session đang hoạt động sẽ được phát lại, giúp lệnh gọi thứ hai có chi phí rất rẻ.

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

**Thời gian phản hồi thông thường:** 200ms (warm) đến hơn 30s (cold solve trên trang web phức tạp)
**Phù hợp nhất cho:** Mục tiêu mới, các trang có nhiều lớp bảo vệ kết hợp, nhu cầu "chỉ cần lấy trang"

Để xem hướng dẫn chi tiết hơn, hãy tham khảo [hướng dẫn Smart Fetch](https://foura.ai/docs/guides/smart-fetch).

### Single (`POST /api/single/`)

Tùy chọn nhanh nhất. Gửi một HTTP request với các đặc tính truyền tải giống hệt trình duyệt thực tế mà không cần khởi chạy tiến trình trình duyệt.

```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://example.com/api/products"}'
```

**Thời gian phản hồi thông thường:** 200ms đến 2s
**Phù hợp nhất cho:** API, trang tin tức, blog, trang sản phẩm tĩnh

### Trình duyệt (`POST /api/browser/`)

Mở URL của bạn trong một phiên bản trình duyệt Chrome. Trang sẽ tải hoàn toàn, JavaScript được thực thi, và bạn nhận được HTML kết xuất cuối cùng.

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'
```

**Thời gian phản hồi thông thường:** 2s đến 10s
**Phù hợp nhất cho:** Ứng dụng trang đơn (SPA), các trang web sử dụng lazy loading, nội dung kết xuất bằng JavaScript

### Proxy (`POST /api/proxy/`)

Kết hợp các HTTP request với cơ chế tự động xoay vòng proxy. Nếu lần thử đầu tiên thất bại hoặc bị chặn, FourA sẽ thử lại qua các proxy khác nhau.

```bash
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'
```

**Thời gian phản hồi thông thường:** 1s đến 5s
**Phù hợp nhất cho:** Theo dõi giá thương mại điện tử, tổng hợp dữ liệu du lịch, các trang web có phát hiện bot

## Auto so với Manual

Khi nào bạn nên để auto tự chọn, và khi nào bạn nên tự gọi Single, Proxy, hoặc Browser?

| Chọn auto | Chọn manual |
|-----------|-------------|
| Bạn chưa biết trang web yêu cầu những gì | Bạn biết chính xác engine mà mục tiêu cần |
| Bạn muốn một lệnh gọi duy nhất hoạt động ngay | Bạn đang tối ưu hóa cấu trúc request cho một mục tiêu đã biết |
| Bạn đồng ý để auto sử dụng lại session đã học | Bạn muốn toàn quyền kiểm soát việc retry, timeout, và lựa chọn proxy theo từng lệnh gọi |
| Bạn chấp nhận chi trả cho vài giây thăm dò ở lệnh gọi đầu tiên | Độ trễ ở lệnh gọi đầu tiên quan trọng hơn quá trình dò tìm |

Auto không phải lúc nào cũng là lựa chọn rẻ hơn. Nếu bạn đã biết mục tiêu hoạt động với Single và bật `unblocker`, việc gọi trực tiếp Single sẽ bỏ qua bậc thang dò tìm và chỉ tốn 2 credit. Dùng auto trên cùng mục tiêu đó sẽ tốn toàn bộ chi phí mà bậc thang của nó đã tiêu thụ.

## Khi nào nên kết hợp các phương pháp

Một số quy trình làm việc sẽ hiệu quả hơn khi sử dụng nhiều endpoint:

1. **Dò tìm với auto**: truyền quy tắc `validate` và để bậc thang tự xác định nấc thang mà trang web yêu cầu.
2. **Phát lại với single**: lấy `session.proxy`, `session.cookies`, và `session.userAgent` mà auto trả về, sau đó gọi Single cùng các giá trị đó cho các trang tiếp theo trên cùng một host.
3. **Dự phòng với browser**: nếu single bắt đầu thất bại, hãy chuyển sang render bằng browser.
4. **Thêm proxy**: nếu bạn bị từ chối (403 hoặc trang xác minh) khi không dùng auto, hãy bọc request trong proxy endpoint để tự động xoay vòng.

Phương pháp tiếp cận lũy tiến này giúp giữ chi phí ở mức thấp trong khi vẫn duy trì tỷ lệ thành công cao.

## Mẹo tối ưu hiệu năng

- Truyền một chuỗi con `validate.data.accept` trên các mục tiêu được bảo vệ. Auto tự nhận diện được các trang thử thách phổ biến, nhưng chỉ có quy tắc của bạn mới bắt được trang kiểm tra mà hệ thống chưa biết, hoặc trang tải xong nhưng thiếu nội dung bạn cần.
- Sử dụng single endpoint theo mặc định cho các host đã biết là hoạt động ổn định và chỉ nâng cấp khi cần thiết.
- Thiết lập `checkText` trong browser request để trang render thiếu nội dung sẽ trả về kết quả thất bại (`checkText:<text> not found`) thay vì thành công. `checkText` không làm cho FourA chờ văn bản lâu hơn.
- Thiết lập `maxTries` trong proxy request để kiểm soát hành vi retry (mặc định là 5, tối đa là 90).
- Giữ `timeout_ms` ở mức hợp lý: 10 đến 15 giây cho hầu hết các trang, 30 giây trở lên cho lần chạy auto khởi động nguội trên các trang được bảo vệ.

## Các bước tiếp theo

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Tìm hiểu sâu về `/api/auto/`
- [API Endpoints](https://foura.ai/docs/api/endpoints): Tài liệu tham khảo đầy đủ về tham số
- [Scrape a Dynamic Website](https://foura.ai/docs/how-to/scrape-dynamic-website): Hướng dẫn từng bước cho browser request
- [Quick Start](https://foura.ai/docs/getting-started/quick-start): Request đầu tiên của bạn trong 30 giây
