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 Dashboard của FourA.
Bước 1: Mở Dashboard
Truy cập vào Dashboard và đăng nhập bằng tài khoản FourA của bạn.
Bước 2: Tạo API Key
Chuyển đến 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 với 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, mục Try it in the Playground sẽ đưa bạn đến giao diện đó.
Nếu bỏ lỡ, sau này bạn có thể nhấp vào biểu tượng con mắt trên hàng của key để hiển thị lại. Các key cũ được tạo trước khi tính năng hiển thị này ra mắt sẽ không thể xem lại; hãy tạo lại một lần để chuyển đổi. Quy trình đầy đủ: Quản lý API Key.
Key của bạn sẽ trông như thế này: pk_live_a1b2c3d4e5f6...
Bước 3: Chọn một Endpoint
FourA có bốn endpoint dành cho các trường hợp khác nhau:
Auto (POST /api/auto/)
Lựa chọn mặc định thông minh. Truyền vào một URL, lý tưởng nhất là kèm theo quy tắc validate, và FourA sẽ thử tuần tự từ proxy xoay vòng đến một trình duyệt hoàn chỉnh qua proxy, dừng lại ở kết quả đầu tiên đạt yêu cầu. Thiết lập forceProxy: false để hệ thống thử một request trực tiếp trước. Phù hợp nhất khi bạn nhắm vào một trang web mới và chưa rõ nó cần những gì.
Single (POST /api/single/)
Gửi một HTTP request nhanh chóng. Phù hợp nhất cho các trang HTML tĩnh và endpoint API. 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 các SPA, nội dung tải chậm (lazy-loaded), 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 các proxy xoay vòng 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ốc truy cập, hoặc trả lờ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 đối tượng, mỗi đối tượng tương ứng với một lần chuyển hướng (redirect hop). Mỗi mục chứa một result bao gồm dòng trạng thái cùng với mọi response header mà trang đích trả về.
Các trường chính:
- status: mã trạng thái HTTP từ trang đích
- data: nội dung 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 6: Thử một Browser Request
Nếu trang đích sử dụng JavaScript để hiển thị 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 chắc nên dùng engine nào | Bắt đầu với auto endpoint. 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 trống | Chuyển từ single sang browser endpoint: trang web có khả năng cần kết xuất JS |
| Trang xác minh trong response | Chuyển sang proxy endpoint để tự động xoay vòng IP |
| Timeout | Tăng timeout_ms hoặc xác minh lại URL đã chính xác chưa |
| Mất khóa API | Nhấp vào biểu tượng con mắt ở hàng chứa khóa trong API Keys để hiển thị lại, hoặc tạo mới nếu đó là khóa phiên bản cũ |
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 request trên dashboard trước khi viết mã
- Smart Fetch (Auto): Tìm hiểu chuyên sâu về auto endpoint
- Lựa chọn đúng endpoint: Bảng so sánh chi tiết
- Các sự cố thường gặp: Xử lý vấn đề nhanh chóng