Tài liệu › Bắt đầu › Hướng dẫn Bắt đầu Nhanh

Hướng dẫn Bắt đầu Nhanh

Đi từ con số không đế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. Nó có dạng như thế này: pk_live_a1b2c3d4e5f6...

Hãy sao chép nó. Bạn sẽ cần nó cho mọi request.

Bước 2: Thực hiện Request Đầu tiên

Mở một 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": [["content-type", "text/html"]],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Các trường chính:

  • status: HTTP status code từ trang web mục tiêu
  • data: response body (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 có ba endpoint cho các tình huống khác nhau:

Endpoint Tốc độ Sử dụng khi
POST /api/single/ Nhanh nhất (200ms-2s) Các trang tĩnh, API, trang web được render phía máy chủ
POST /api/browser/ Trung bình (2s-10s) Các trang nặng JavaScript, SPA, nội dung động
POST /api/proxy/ Nhanh (1s-5s) Các trang web có phát hiện bot, nội dung bị giới hạn địa lý

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 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

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