Tạo Tác vụ

Hướng dẫn này sẽ chỉ dẫn bạn cách tạo một API key và gửi request đầu tiên bằng FourA Dashboard.

Bước 1: Mở Dashboard

Truy cập Dashboard và đăng nhập bằng tài khoản FourA của bạn.

Bước 2: Tạo API Key

Đi tới trang API Keys và nhấp vào Create API key. Khi bạn đã có key, nút phía trên danh sách sẽ hiển thị là Create Key.

Đặt cho key một tên mang tính mô tả (ví dụ: "production-scraper" hoặc "dev-testing"). Hộp thoại API Key Created sẽ hiển thị key dạng văn bản thuần túy cùng nút sao chép, và bên dưới mục Test your first request là lệnh curl sẵn sàng để chạy cùng nút Copy command. Trên điện thoại hoặc máy tính bảng, tùy chọn Try it in the Playground sẽ đưa bạn đến thẳng trang đó.

Nếu bạn bỏ lỡ, hãy nhấp vào biểu tượng con mắt trên hàng của key sau đó để hiển thị lại. Các key cũ được tạo trước khi tính năng hiển thị lại ra mắt sẽ không thể khôi phục; hãy tạo lại chúng một lần để chuyển đổi. Toàn bộ quy trình: Quản lý API Keys.

Key của bạn có dạng như sau: pk_live_a1b2c3d4e5f6...

Bước 3: Chọn một Endpoint

FourA có bốn endpoint cho các trường hợp khác nhau:

Auto (`POST /api/auto/`)

Mặc định thông minh. Truyền một URL cùng với quy tắc validate và FourA sẽ chọn đường dẫn rẻ nhất hoạt động được: direct request, rotating proxy, hoặc full browser. Phù hợp nhất khi bạn nhắm mục tiêu vào một trang web mới và chưa biết trang đó cần gì.

Single (`POST /api/single/`)

Gửi một HTTP request nhanh. Phù hợp nhất cho các trang HTML tĩnh và các API endpoint. Thời gian phản hồi: thường dưới 2 giây.

Browser (`POST /api/browser/`)

Chạy một phiên bản trình duyệt Chrome để kết xuất JavaScript. Phù hợp nhất cho SPA, nội dung lazy-load, và các trang yêu cầu thực thi JS. Thời gian phản hồi: từ 2 đến 10 giây.

Proxy (`POST /api/proxy/`)

Định tuyến request qua rotating proxy với cơ chế thử lại tự động. Phù hợp nhất cho các trang web kiểm tra nguồn gửi request, hoặc phản hồi khác nhau tùy theo quốc gia.

Bước 4: Gửi Request Đầu Tiên Của Bạn

Mở terminal và chạy:

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

Bước 5: Đọc Response

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

Trường headers là một mảng các object, tương ứng với mỗi chặng redirect. Mỗi mục có một result chứa dòng trạng thái cùng mọi response header mà trang đích trả về.

Các trường chính:

status: HTTP status code từ trang đích
data: response body (HTML, JSON, hoặc text thô)
total_time: thời gian thực hiện request tính bằng giây

Bước 6: Thử một Browser Request

Nếu trang đích sử dụng JavaScript để render nội dung, hãy dùng browser endpoint để thay thế:

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

Response của trình duyệt sử dụng body thay vì data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Các sự cố thường gặp

Vấn đề	Giải pháp
Không rõ nên dùng engine nào	Bắt đầu với endpoint auto. Nó sẽ chọn đường dẫn phù hợp và ghi nhớ phương án hoạt động hiệu quả.
Nội dung rỗng	Chuyển từ endpoint single sang browser: trang có thể cần render JS
Trang xác minh trong response	Chuyển sang endpoint proxy để tự động xoay vòng IP
Timeout	Tăng `timeout_ms` hoặc kiểm tra lại xem URL đã chính xác chưa
Mất API key	Nhấp vào biểu tượng mắt ở dòng của key trong mục API Keys để hiển thị, hoặc tạo lại nếu là key cũ (legacy)

Các bước tiếp theo

Tổng quan Dashboard: Hướng dẫn chi tiết toàn bộ dashboard
Playground: Thử nghiệm các request trên dashboard trước khi viết code
Smart Fetch (Auto): Tìm hiểu chuyên sâu về endpoint auto
Chọn đúng Endpoint: So sánh chi tiết
Các sự cố thường gặp: Xử lý sự cố nhanh chóng

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