Gửi Request Đầu Tiên

Hướng dẫn này sẽ dẫn dắt bạn qua các bước tạo 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 Key.

Đặt cho key một tên dễ nhớ (ví dụ: "production-scraper" hoặc "dev-testing"). Toàn bộ key chỉ hiển thị một lần duy nhất, vì vậy hãy sao chép ngay lập tức.

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

Bước 3: Chọn Endpoint

FourA có ba endpoint cho các tình huống khác nhau:

Single (`POST /api/single/`)

Gửi một HTTP request nhanh. Tốt nhất cho các trang HTML tĩnh và các API endpoint. Thời gian response: thường dưới 2 giây.

Browser (`POST /api/browser/`)

Chạy một phiên bản trình duyệt Chrome để render JavaScript. Tốt nhất cho các SPA, nội dung lazy-load và các trang yêu cầu thực thi JS. Thời gian response: từ 2 đến 10 giây.

Proxy (`POST /api/proxy/`)

Định tuyến request qua các proxy xoay vòng với tính năng tự động thử lại. Tốt nhất cho các trang web có hệ thống phát hiện bot hoặc nội dung bị giới hạn địa lý.

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

Mở terminal và chạy lệnh:

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": [["content-type", "text/html"]],
  "data": "<html>...</html>",
  "total_time": 0.45
}

Các trường quan trọng:

status: mã trạng thái HTTP từ trang web mục tiêu
data: phần body của response (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 6: Thử một Browser Request

Nếu trang mục tiêu sử dụng JavaScript để render nội dung, hãy sử 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 Vấn Đề Thường Gặp

Vấn đề	Giải pháp
Nội dung trống	Chuyển từ single sang browser endpoint: trang web có thể cần render JS
Captcha trong response	Chuyển sang proxy endpoint để tự động xoay vòng IP
Timeout	Tăng `timeout_ms` hoặc kiểm tra xem URL đã chính xác chưa

Các Bước Tiếp Theo

Dashboard Overview: Hướng dẫn chi tiết về dashboard
Playground: Thử nghiệm các request trong dashboard trước khi viết code
Choosing the Right Endpoint: So sánh chi tiết
Common Issues: Giải quyết các vấn đề nhanh chóng

Cập nhật: 1 tháng 7, 2026