Tài liệu › Bắt đầu › Bắt đầu nhanh

Bắt đầu nhanh

Đi từ con số 0 đến lần thu thập dữ liệu đầu tiên của bạn trong chưa đầy hai phút.

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

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

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

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

Bước 2: Tạo request đầu tiên của bạn

Mở terminal và chạy lệnh sau (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 object, mỗi object tương ứng với một bước chuyển hướng (redirect hop). Mỗi mục có một trường result chứa dòng trạng thái cùng với mọi response header mà mục tiêu trả về cho bước đó.

Các trường chính:

  • status: Mã trạng thái HTTP từ trang mục tiêu
  • data: Nội dung response (HTML, JSON hoặc văn bản thô)
  • total_time: Thời lượng request tính bằng giây

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

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

Endpoint Tốc độ Sử dụng khi
POST /api/auto/ Thay đổi (nhanh trên các warm host) Bạn không biết trang web cần engine nào. Truyền một URL và để FourA chọn đường dẫn rẻ nhất có thể hoạt động.
POST /api/single/ Nhanh nhất (200ms-2s) Trang tĩnh, API, trang web render từ server
POST /api/browser/ Trung bình (2s-10s) Trang nặng JavaScript, SPA, nội dung động
POST /api/proxy/ Nhanh (1s-5s) Trang web có bot detection, nội dung bị giới hạn địa lý

Thử một auto request (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ử 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 proxy request (tự động luân phiên 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

Cập nhật: 1 tháng 7, 2026
Xác thực →