Playground (thanh bên > Playground) cho phép bạn chạy các request API trực tiếp với API key thực tế của mình mà không cần viết mã. Đây là cách nhanh nhất để thử nghiệm một trang web mục tiêu mới, gỡ lỗi một response phức tạp hoặc so sánh song song Auto, Single, Proxy và Browser.

Mở tại foura.ai/dashboard#playground.

Tính năng

Một biểu mẫu. Bốn engine. Lưu lượng truy cập thực tế.

  • Auto: fetch thông minh. Bạn truyền một URL cùng một quy tắc validate và FourA sẽ chọn đường dẫn tiết kiệm nhất có thể hoạt động.
  • Single: HTTP fetch trực tiếp với các đặc tính wire giống trình duyệt thực tế
  • Proxy: fetch qua proxy luân phiên được quản lý, tùy chọn giới hạn theo quốc gia hiển thị với mục tiêu
  • Browser: mở URL trong một phiên bản trình duyệt Chrome cho các trang hiển thị bằng JS

Các request chạy bằng API key bạn chọn ở đầu trang. Mức sử dụng sẽ tính vào hạn ngạch của key đó tương tự như lệnh gọi trong môi trường production, vì vậy tránh dùng cạn gói dịch vụ khi thử nghiệm.

Chọn Key

Menu thả xuống API key liệt kê tất cả các key đang hoạt động bạn có thể dùng: key riêng của bạn trong mục My Keys, tiếp theo là từng nhóm cho mỗi tổ chức bạn tham gia. Bất kỳ thành viên nào cũng có thể chạy key của tổ chức, và request qua key đó sẽ tính vào gói của chủ sở hữu tổ chức. Hãy chọn key bạn muốn tính phí request. Nếu bạn chưa có key đang hoạt động nào, một thông báo nội dòng sẽ dẫn bạn đến trang API Keys để tạo mới.

Chọn Chế độ

Hàng Mode ở trên cùng chuyển đổi giữa Auto và các engine thủ công. Khi chọn Auto, biểu mẫu sẽ chuyển sang giao diện Auto tối giản (URL cùng với validate và một vài tùy chỉnh). Cả hai hàng luôn hiển thị: Mode: Auto, và Endpoint: Single, Proxy, Browser. Chọn một mục sẽ bỏ chọn mục còn lại. Việc chuyển đổi endpoint sẽ thay đổi các trường hiển thị và engine mà request gửi tới. Lựa chọn hiện tại được giữ nguyên khi bạn tải lại trang.

Chế độ Khi nào nên dùng
Auto Mục tiêu mới hoặc trang web có nhiều lớp bảo vệ khác nhau. Auto chọn đường dẫn tiết kiệm nhất và ghi nhớ phương án hiệu quả.
Single HTTP fetch nhanh. Lựa chọn ưu tiên tốt nhất cho host đã biết.
Proxy Cùng kiểu fetch với tính năng xoay proxy tự động. Thiết lập exitCountries khi bạn cần quốc gia hiển thị với mục tiêu.
Browser Tải trang trong một phiên bản trình duyệt Chrome. Dùng khi dữ liệu chỉ xuất hiện sau khi JavaScript chạy.

Tạo Request

Hàng URL

Hàng trên cùng chứa phương thức HTTP (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), URL mục tiêu và nút Send. Single, Proxy và Auto hỗ trợ mọi phương thức. Browser bỏ qua phương thức (Chrome luôn gửi GET khi điều hướng) và body.

Các Tab Request

Bên dưới hàng URL, năm tab cho phép bạn điền mọi thông tin còn lại:

Tab Chức năng điều khiển
UI Các trường biểu mẫu cho timeout, chuyển hướng, flag, proxy, tùy chọn dành riêng cho trình duyệt và quy tắc xác thực
Body Body dạng tự do cho các request POST / PUT / PATCH
Headers Header request tùy chỉnh dưới dạng các cặp key-value
Cookies Cookie jar được lưu theo từng host trong trình duyệt này. Use jar sẽ đính kèm các cookie phù hợp vào request và Save response cookies sẽ lưu các cookie do response thiết lập. Cả hai đều được bật theo mặc định, và tab này hiển thị trước những gì request sẽ gửi
Raw Payload JSON chính xác sẽ được gửi đi, hiển thị dưới dạng bản xem trước chỉ đọc cùng nút Copy JSON, kèm lệnh curl tái tạo bên dưới

Bất kỳ thay đổi nào trong UI / Body / Headers / Cookies đều được phản ánh trong Raw. Bạn không thể nhập trực tiếp vào Raw: hãy thay đổi request ở các tab khác. Chấm đỏ xuất hiện trên bất kỳ tab hoặc mục thu gọn nào chứa giá trị khác với mặc định của engine, giúp bạn nhận biết ngay những gì đã tùy chỉnh.

Các mục trong khung UI

Tab UI nhóm các cài đặt vào những mục có thể thu gọn. Các trường để trống sẽ sử dụng giá trị schema mặc định của engine. Các mục không áp dụng cho Mode hiện tại sẽ bị ẩn.

  • Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Browser và Auto chỉ hiển thị timeout_ms (trên Auto, là tổng ngân sách thời gian).
  • Redirects: bật/tắt và thiết lập followRedirects (0-20). Áp dụng cho Single và Proxy. Browser tự động chuyển hướng độc lập.
  • Flags: unblocker cho Single, Proxy, và Browser (unblocker trên Browser hoàn thành các quy trình kiểm tra do trang yêu cầu); tryJsonData và returnBuffer cho Single và Proxy. Auto hiển thị forceProxy và returnSession thay thế.
  • Proxy: chọn một proxy ID cụ thể cho Single hoặc Browser, hoặc đặt maxTries, timeout bên ngoài của Proxy, exitCountries, exitClass, và ignoreProxies cho engine Proxy. Auto cũng hiển thị ignoreProxies và exitClass. Trình chọn exitClass có ba trạng thái: không chọn sẽ không gửi trường nào cả, standard chỉ định nhóm tiêu chuẩn, và premium cho phép request nâng cấp lên exit cao cấp khi nhóm tiêu chuẩn gặp sự cố. Trạng thái không chọn và standard đều giữ nguyên trên nhóm tiêu chuẩn; một request thành công có chỉ định lớp sẽ nhận lại exitClass. Lựa chọn Premium cần gói dịch vụ có hỗ trợ exit cao cấp: xem exitClass.
  • Browser profile: ba menu thả xuống dạng xếp tầng, os, browser, và version, liệt kê các cấu hình FourA thực tế có thể cung cấp. Chúng xuất hiện trong chế độ Single và Proxy. Để trống để sử dụng Chrome mới nhất. Mỗi mục chọn sẽ thu hẹp hai mục còn lại, nhằm tránh trường hợp cấu hình kết hợp không hợp lệ xuất hiện. Phần này yêu cầu bật unblocker: nếu tắt, không có header trình duyệt nào được gửi, profile chỉ áp dụng một nửa, và API sẽ từ chối request.
  • Browser: các tùy chọn chỉ dành cho browser như checkStatus và checkText.
  • Validate: status accept và status fail nhận các mã trạng thái phân tách bằng dấu phẩy (validate.status), còn body accept và body fail nhận các chuỗi con với các phương án phân tách bằng | (validate.data). Hỗ trợ cho Single, Proxy, và Auto. Browser sử dụng checkStatus và checkText thay thế. Biểu mẫu không có trường cho các quy tắc header (validate.headers).

Khi một lượt chạy trả về một proxy hoạt động tốt, mục Working proxies sẽ xuất hiện ở cuối tab giao diện. Mục này liệt kê tối đa 20 proxy ID, mới nhất xếp trước, mỗi proxy đi kèm quốc gia exit và thời gian. use sẽ điền proxy đó vào trường proxy trên Single hoặc Browser (engine Proxy tự tìm proxy riêng), và × sẽ xóa proxy khỏi danh sách.

Phạm vi Quốc gia Exit (Chế độ Proxy)

Trường exitCountries trên Proxy chấp nhận danh sách phân tách bằng dấu phẩy gồm các mã quốc gia hai chữ cái hiển thị với đích đến (CZ, GB). Các giá trị được loại bỏ khoảng trắng, chuyển thành chữ hoa và khử trùng lặp khi gửi. Việc lựa chọn từ pool tiêu chuẩn tuân theo một allowlist nghiêm ngặt: các proxy có cổng thoát không xác định sẽ bị loại trừ và pool không bao giờ chuyển hướng dự phòng sang quốc gia khác. Cổng thoát premium cũng tuân theo danh sách này. Khi exitClass được đặt thành premium, cổng thoát premium sẽ đi từ một trong các quốc gia được liệt kê, và quốc gia mà pool tiêu chuẩn không có sẽ được chuyển sang các cổng thoát premium tại đó. Nếu không có premium, một pool không có kết quả phù hợp sẽ trả về code: "no_eligible_proxy" kèm theo phạm vi đã yêu cầu được lặp lại trong details.exitCountries. Hãy giữ nguyên phạm vi và thử lại sau.

Khi một lệnh gọi proxy thành công trong phạm vi đã định, dải phản hồi sẽ hiển thị exit <CODE> bên cạnh proxy ID để bạn có thể xác minh quốc gia được phân phát khớp với yêu cầu của mình.

Vị trí cổng thoát (Chế độ Proxy)

Nhóm Exit location trên Proxy chọn nơi cổng thoát premium đi ra: khu vực, thành phố, mạng, thiết bị và thời gian duy trì địa chỉ của nó. Danh sách khu vực, thành phố và mạng sẽ được điền khi exitCountries chỉ định chính xác một quốc gia. Hãy đặt exitClass thành premium, vì bất kỳ tùy chọn nào trong số này đều chỉ gửi request qua các cổng thoát premium. Proxy ID trong phản hồi sẽ giữ nguyên vị trí, do đó chỉ cần chuyển nó vào Single hoặc Browser là đủ cho cả hai chế độ này. Xem Vị trí cổng thoát.

Đặt lại thanh công cụ

Nút Reset trên thanh công cụ (bên cạnh History và Saved) xóa sạch playground về trạng thái ban đầu. Vì đây là thao tác có tính phá hủy, nó sẽ mở một hộp thoại xác nhận liệt kê chính xác những gì sẽ bị xóa: mọi tab request, mọi cookie đã lưu trong jar, mọi proxy đang lưu giữ và response hiện tại. Các preset đã lưu và API key đã chọn sẽ được giữ lại. Nhấp vào Reset everything để xác nhận; bất kỳ thao tác nào khác sẽ hủy bỏ.

Gửi và Hủy

Nhấp vào Send để kích hoạt request. Cột bên phải chuyển sang trạng thái đang tải với biểu tượng vòng xoay và nút Cancel trong khi lệnh gọi đang diễn ra. Nhấp vào Cancel (hoặc nhấn lại nút này trên thiết bị di động) để hủy bỏ. Một request bị hủy sẽ khôi phục phần giữ chỗ trạng thái rảnh với thông báo "Request canceled." thay vì hiển thị lỗi.

Thẻ response sẽ chuyển sang kết quả ngay khi request hoàn tất (hoặc thất bại). Trên điện thoại, hoặc trong bất kỳ cửa sổ nào đủ hẹp để đặt response dưới form, trang sẽ cuộn thẻ response vào tầm nhìn khi nó xuất hiện ở vị trí thấp trên màn hình. Các lượt chạy Auto có thể mất nhiều thời gian hơn các engine thủ công vì hệ thống có thể cần nâng dần từng bước xử lý trên một mục tiêu chưa có dữ liệu đệm.

Đọc Response

Cột response phản chiếu bố cục request với các tab riêng:

Thẻ Nội dung hiển thị
Body Body đã phân tích cú pháp. Chuyển đổi giữa các chế độ xem JSON, HTML và Text tùy thuộc vào dữ liệu trả về.
Headers Các response header, mỗi dòng một header.
Cookies Cookie được trả về bởi mục tiêu, ở cả chế độ xem đã phân tích cú pháp (nhóm theo host) và thô (văn bản Set-Cookie). Chế độ xem đã phân tích cú pháp hiển thị huy hiệu HO trên các cookie host-only; cookie domain không được đánh dấu.
Raw Toàn bộ envelope JSON do API trả về.

Thanh công cụ response có Copy và Download cho toàn bộ response, cùng Find in response (Ctrl+K hoặc Cmd+K) để tìm kiếm trong thẻ đang mở, sử dụng Enter và Shift+Enter để duyệt qua các kết quả khớp. Body, Headers và Cookies cũng có nút Copy và Download riêng cho từng thẻ tương ứng.

Một dải meta phía trên các thẻ hiển thị HTTP status từ upstream, tổng thời gian, proxy ID đã xử lý lệnh gọi, và (đối với lệnh gọi Proxy có scope) mã hai chữ cái exit <CODE>. Dải này cũng hiển thị kích thước response và số credit mà request đã tiêu tốn khi API báo cáo. Đối với các lượt chạy Auto, cấp độ và số lần thử nằm trong câu bên dưới dải meta.

Những gì lệnh gọi đã cần

Một câu bên dưới dải meta mô tả bằng văn bản những gì đã tải trang. Đối với một lượt chạy Auto, câu này nêu rõ cấp độ (session FourA đã có sẵn cho host, request thông thường, proxy xoay vòng, trình duyệt thực, hoặc dùng trình duyệt trước rồi replay tiết kiệm chi phí), liệu thử thách có được giải quyết hay không, số lần thử cần thiết, và chi phí phát sinh. Khi request thiết lập exitClass, câu này cũng cho biết exit cao cấp hay pool tiêu chuẩn đã phân phối nó.

Khi một trong các giới hạn trong gói của bạn từ chối lệnh gọi, câu này sẽ thông báo trước: "Bị dừng bởi gói của bạn, không phải bởi trang web", tiếp theo là giới hạn cụ thể (đã dùng hết request trình duyệt hôm nay, quá nhiều request đang xử lý, đã tiêu hết credit kỳ này, v.v.) và một liên kết đến Usage & Limits. Dòng này được tạo từ mã X-FourA-Limit mà API trả về, vì vậy một trang phức tạp gặp lỗi sẽ cho bạn biết trang web đã chặn hay gói dịch vụ đã dừng nó.

Chuyển giá trị giữa các lượt chạy

Sau bất kỳ lượt chạy nào trả về dữ liệu session có thể tái sử dụng, một tùy chọn Carry nhỏ trên thanh công cụ response sẽ hiển thị những gì khả dụng:

  • Các lượt chạy Auto được thực hiện với returnSession sẽ cung cấp userAgent và proxy của session. Cookie của session hiển thị trên thẻ Cookies của response, và được lưu vào cookie jar khi bật Save response cookies.
  • Các lượt chạy Browser cung cấp userAgent của response, kèm theo proxy ID nếu có sử dụng.
  • Các lượt chạy Proxy cung cấp proxy ID được trả về, cùng hồ sơ trình duyệt khi cơ chế xoay vòng chọn hồ sơ bạn không yêu cầu.

Nhấp vào Carry và chọn nơi áp dụng từng giá trị chỉ với một lần nhấp: userAgent trở thành header User-Agent trên Single hoặc Proxy, và proxy ID được điền vào trường proxy trên Single hoặc Browser. Các trường nhận giá trị chuyển tiếp sẽ hiển thị chấm đỏ "đã sửa đổi" để bạn thấy rõ những gì đã thay đổi.

Một browser profile được mang theo sẽ điền vào ba trường chọn os, browser, version và bật unblocker, cùng quy tắc áp dụng khi bạn chọn profile thủ công. Tùy chọn này chỉ xuất hiện khi danh mục profile đã tải xong, vì biểu mẫu gồm ba trường chọn chứ không phải một trường id.

Profile là giá trị duy nhất cho biết request thành công không phải là request bạn đã nhập: Proxy chỉ báo cáo profile khi nó chuyển sang một nhóm browser bạn không yêu cầu. Phát lại mà không có nó nghĩa là bạn phát lại phiên bản đã thất bại. Xem Tại sao một Proxy Request hết lượt thử.

Mở rộng toàn màn hình

Biểu tượng mở rộng trên thanh công cụ response sẽ tách thẻ response ra khỏi bố cục chia đôi và đưa vào lớp phủ toàn màn hình. Dùng tính năng này cho các cây JSON nhiều tầng, danh sách Set-Cookie dài, hoặc nội dung HTML rộng khi cột nửa màn hình bị chật. Bản thân trang sẽ dừng cuộn khi lớp phủ đang mở. Nhấp lại vào biểu tượng (hoặc nhấn Escape) để thu nhỏ.

Trình tái tạo curl

Trên tab Raw của request, phía dưới JSON, một khối curl hiển thị dòng lệnh tương đương chính xác với request bạn đang tạo, kèm nút Copy curl. Sao chép dòng lệnh này để tái hiện request từ terminal, chia sẻ với đồng đội, hoặc dán vào báo cáo lỗi.

Đối với các key cho phép hiển thị, nút Reveal key cạnh đoạn mã sẽ chèn trực tiếp key dạng plain-text vào curl để bạn có thể sao chép và chạy ngay. Nhấp lại để ẩn. Các key cũ (tạo trước khi có tính năng hiển thị) giữ lại placeholder PASTE_PLAINTEXT_FOR_<key-name>; hãy tạo lại key từ trang API Keys để có thể hiển thị được.

Hành động hiển thị key luôn được ghi nhận nhật ký kiểm toán trên server mỗi lần thực hiện, và plain key chỉ lưu trong bộ nhớ cho phiên làm việc hiện tại của trang.

Lưu Preset

Nếu bạn phải cấu hình lại cùng một target nhiều lần, hãy lưu lại. Nhấp Save trên hàng tab request để lưu cấu hình hiện tại thành một preset có tên.

Mở Saved trên thanh công cụ để xem các preset của bạn. Nhấp Load để điền vào biểu mẫu, hoặc Delete để xóa preset.

Một request được mở từ tab DevTools của FourA Chrome extension sẽ tải cùng key của extension được chọn nếu key đó nằm trong tài khoản của bạn, và trang sẽ thông báo điều đó. Nếu không, trang sẽ yêu cầu bạn chọn một key. Một request phát lại không thiết lập unblocker sẽ chạy với tùy chọn này được bật, tương tự như cách API hoạt động.

Trường preset Dữ liệu lưu trữ
Name Nhãn ngắn (tối đa 100 ký tự)
Description Ghi chú tùy chọn (tối đa 500 ký tự)
Endpoint Engine áp dụng preset (auto / single / proxy / browser)
Config Toàn bộ payload của request, bao gồm các trường UI, header, cookie, và body

Preset được giới hạn theo tài khoản người dùng của bạn và không được chia sẻ với các thành viên trong nhóm.

Phát lại từ History

Mọi request bạn chạy đều được ghi nhật ký. Mở History trên thanh công cụ để xem 20 lần chạy gần nhất, sắp xếp mới nhất trước.

Mỗi hàng hiển thị endpoint, URL mục tiêu, trạng thái và thời gian. Nhấp vào Replay ở bất kỳ hàng nào để tải lại request đó vào biểu mẫu, sau đó chọn Send để chạy lại.

Lịch sử được tự động giới hạn theo tài khoản của bạn: bạn chỉ thấy các lượt chạy của chính mình.

Mở từ Activity

Hộp thoại chi tiết Activity Log có nút Open in Playground. Nhấp vào nút này và Playground sẽ tải cả request đã lưu trữ lẫn response đã lưu trữ. Biểu mẫu được điền từ payload đã lưu, và thẻ response hiển thị nội dung API đã trả về tại thời điểm đó với huy hiệu "archived" trên thanh proxy meta ("archived

Từ đó, bạn có thể thay đổi một tham số và nhấn Send để chạy một request mới tới API trực tiếp, hoặc chỉ kiểm tra payload đã lưu trữ mà không cần chạy lại. Payload được lưu giữ trong 24 giờ, vì vậy các hàng Activity cũ hơn sẽ không có response để tải lại.

Mẹo

  • Bắt đầu trong Playground trước khi viết mã cho một mục tiêu mới. Khi bật Auto, bạn sẽ biết chỉ trong vài giây liệu một lượt fetch chi phí thấp đã đủ hay trang web bắt buộc phải xử lý qua trình duyệt.
  • Đối với các mục tiêu bị khóa theo quốc gia, hãy chạy một lệnh gọi Proxy với exitCountries được thiết lập, sau đó chuyển ID proxy được trả về vào lệnh gọi Browser để quá trình kết xuất JavaScript diễn ra qua cùng một cổng thoát.
  • Lưu một preset cho mọi mục tiêu bạn scrape thường xuyên. Phát lại một preset đã lưu chỉ mất một lần nhấp; dựng lại request từ trí nhớ sẽ mất nhiều thời gian hơn.
  • Sử dụng tab Cookies để gỡ lỗi scraping dựa trên phiên. Chế độ xem Set-Cookie thô hiển thị chính xác những gì mục tiêu đã gửi.
  • Khi một mục tiêu từ chối bạn, hãy thử một mục khác trong danh sách chọn Browser profile trước khi tìm đến một engine nặng hơn. Đổi trình duyệt đại diện là miễn phí; kết xuất bằng trình duyệt thì không.
  • Các request trong Playground được tính phí vào API key bạn chọn. Hãy dùng một key riêng có hạn mức thấp cho việc khám phá thông thường nếu bạn muốn giữ dữ liệu sử dụng production được sạch sẽ.
  • API Endpoints: Tài liệu tham khảo tham số đầy đủ cho cả bốn engine, bao gồm exitCountries và các trường browser profile
  • Smart Fetch (Auto): Cơ chế hoạt động bên dưới của Auto
  • Choosing the Right Endpoint: Khi nào nên chọn Auto so với Single so với Proxy so với Browser
  • API Keys: Quản lý các key bạn dùng để xác thực các request trong Playground
  • Activity Log: Mở một request trong quá khứ trực tiếp vào Playground
  • Dashboard Overview: Tất cả các mục trong thanh bên
Cập nhật: 11 tháng 11, 2026