Bắt đầu nhanh

Bắt đầu từ con số không đến lần thu thập dữ liệu đầu tiên của bạn trong vòng chưa đầy hai phút.

Điều kiện tiên quyết

Tài khoản FourA (đăng ký tại đây)
API key của bạn (tạo một key trong Dashboard)

Bước 1: Lấy API Key của bạn

Đăng nhập vào Dashboard và tạo một API key. Mã có dạng như sau: pk_live_a1b2c3d4e5f6...

Sao chép mã này. Bạn sẽ cần nó cho mỗi request.

Bước 2: Thực hiện Request đầu tiên của bạn

Mở terminal và chạy lệnh này (thay thế YOUR_API_KEY bằng key thực tế của bạn):

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

Lệnh này gửi một HTTP request đến example.com và trả về HTML của trang.

Bước 3: Đọc Response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Trường headers là một mảng các đối tượng, mỗi đối tượng tương ứng với một chặng chuyển hướng (redirect hop). Mỗi mục chứa một trường result gồm dòng trạng thái cùng với mọi response header mà trang đích trả về cho chặng đó.

Các trường chính:

status: Mã trạng thái HTTP từ trang đích
data: Phần thân phản hồi (HTML, JSON, hoặc văn bản thô)
total_time: Thời gian thực hiện request tính bằng giây

Bước 4: Thử các Endpoint khác nhau

FourA cung cấp bốn endpoint cho các trường hợp sử dụng khác nhau:

Endpoint	Tốc độ	Sử dụng khi
`POST /api/auto/`	Thay đổi (nhanh trên các host đã khởi động sẵn)	Bạn không biết trang web cần engine nào. Chỉ cần truyền một URL và để FourA tự chọn phương thức tối ưu chi phí nhất có thể hoạt động.
`POST /api/single/`	Nhanh nhất (200ms-2s)	Trang tĩnh, API, trang web render phía máy chủ (SSR)
`POST /api/browser/`	Trung bình (2s-10s)	Trang web dùng nhiều JavaScript, SPA, nội dung động
`POST /api/proxy/`	Nhanh (1s-5s)	Trang web kiểm tra đối tượng truy cập, nội dung thay đổi theo quốc gia

Thử một request ở chế độ auto (mặc định thông minh):

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ử gửi một browser request:

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", "timeout_ms": 15000}'

Thử một request qua proxy (tự động xoay vòng proxy):

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

Bước tiếp theo

Xác thực: Quản lý và bảo mật API key
API Endpoints: Tài liệu tham khảo tham số đầy đủ cho cả bốn endpoint
Smart Fetch (Auto): Cách endpoint tự động quyết định tác vụ cần thực hiện
SDK và thư viện: Ví dụ bằng Python, Node.js, Go, Ruby
Chọn endpoint phù hợp: Khi nào nên chọn auto, single, browser hoặc proxy

Cập nhật: 27 tháng 9, 2026