# Bắt đầu nhanh

> URL: https://foura.ai/vi/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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](https://foura.ai))
- API key của bạn (tạo một key trong [Dashboard](https://foura.ai/dashboard))

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

Đăng nhập vào [Dashboard](https://foura.ai/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):

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

```json
{
  "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):

```bash
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:

```bash
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):

```bash
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](https://foura.ai/docs/getting-started/authentication): Quản lý và bảo mật API key
- [API Endpoints](https://foura.ai/docs/api/endpoints): Tài liệu tham khảo tham số đầy đủ cho cả bốn endpoint
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Cách endpoint tự động quyết định tác vụ cần thực hiện
- [SDK và thư viện](https://foura.ai/docs/getting-started/sdks-and-libraries): Ví dụ bằng Python, Node.js, Go, Ruby
- [Chọn endpoint phù hợp](https://foura.ai/docs/guides/choosing-task-type): Khi nào nên chọn auto, single, browser hoặc proxy
