Kết quả Request
Mỗi request gửi đến FourA API đều được phân loại vào chính xác một outcome, và mỗi tunnel qua cổng proxy cũng vậy. Outcome được tính toán một lần khi kết thúc lệnh gọi và được ghi nhận cho thông tin xác thực đã thực hiện nó. Bảng điều khiển, luồng hoạt động và phần thanh toán của bạn đều đọc cùng một trường này.
Chỉ success mới tiêu tốn credit. Lưu lượng truy cập cao cấp được tính riêng biệt với credit và không phụ thuộc vào outcome: xem Ý nghĩa thanh toán.
Bảy outcome
Dưới đây là bảy kết quả mà một request có thể nhận. Một tunnel sử dụng năm trong số đó: xem Tunnel sử dụng cùng hệ thống thuật ngữ bên dưới.
| Outcome | Tầng | Ý nghĩa |
|---|---|---|
success |
k/d | Phản hồi hợp lệ đã được gửi đến. Tính vào hạn mức thanh toán của bạn. |
application_error |
target | Mục tiêu trả về HTTP 200, nhưng phần thân chứa trường lỗi, hoặc phần thân là trang kiểm tra bot hoặc trang từ chối mà FourA nhận diện được. |
application_fail |
target | Mục tiêu trả về trạng thái khác 200 mà các quy tắc validate của bạn không chấp nhận hoặc bạn không gửi validate, hoặc hoàn toàn không có phản hồi, bao gồm trường hợp tên host mục tiêu không thể phân giải. |
client_error |
caller | Request của bạn bị từ chối trước khi rời khỏi FourA. Tham số không hợp lệ, giá trị proxy sai định dạng, URL bị chặn bởi bảo vệ SSRF. |
rate_limit |
FourA | Request bị từ chối trước khi chạy: do một trong các giới hạn gói cước của bạn (403 đối với endpoint hoặc tham số không có trong gói, 429 đối với hạn mức đã dùng hết), hoặc do hạn mức RPM hoặc concurrency dùng chung của nền tảng. |
service_error |
FourA | Engine phản hồi bằng lỗi server, hoặc phần thân không phải là JSON hợp lệ. |
service_fail |
FourA | Mạng nội bộ của FourA gặp sự cố: engine không phản hồi kịp thời hoặc kết nối bị ngắt, hoặc bạn đã ngắt kết nối. |
Cột tầng cho bạn biết bên nào chịu trách nhiệm:
- Các outcome target liên quan đến trang web bạn đã gọi. Request của bạn đến FourA bình thường, và FourA kết nối đến mục tiêu bình thường. Chính mục tiêu đã trả về lỗi.
- Các outcome caller nghĩa là request của bạn không hợp lệ ngay từ đầu. Hãy sửa lại cấu trúc request.
- Các outcome FourA là lỗi từ phía chúng tôi. Hãy thử lại và kiểm tra trang trạng thái nếu lỗi vẫn tiếp diễn.
Trang mục tiêu trả về 403 được tính là application_fail, không phải client_error. Lệnh gọi của bạn có cấu trúc hoàn toàn hợp lệ. Chỉ là trang web đó từ chối tiếp nhận.
Dấu hiệu nhận biết lệnh gọi thất bại
Lệnh gọi đã đến FourA và được thực thi sẽ trả về HTTP 200 bất kể điều gì xảy ra sau đó. Chỉ trường hợp bị từ chối trước khi fetch (400, 401, 403, 413, 429) hoặc sự cố từ phía FourA (5xx) mới sử dụng mã trạng thái HTTP khác. Vì vậy, outcome được đọc từ body, không phải từ mã trạng thái truyền tải.
| Body | Chuyện gì đã xảy ra | Kết quả |
|---|---|---|
status: 200, headers, data, không có error |
Trang đã được phân phối thành công. | success |
status khác 200, headers, data, không có error |
Máy chủ đích đã phản hồi và bạn không gửi validate. Phản hồi nằm trong data. |
application_fail |
status khác 200, headers, data và error |
Máy chủ đích đã phản hồi và các quy tắc validate của bạn đã từ chối, ví dụ Status 404 is not in accept list 200. |
application_fail |
status: 200, headers, data và error |
Máy chủ đích phản hồi HTTP 200 và các quy tắc validate của bạn đã từ chối, ví dụ Data not in accept list ["product"]. |
application_error |
Chỉ có error và total_time, không có status, không có data |
Máy chủ đích không phản hồi HTTP: đã đạt giới hạn chuyển hướng (Number of redirects hit maximum amount), hết thời gian kết nối hoặc đọc, kết nối bị đặt lại, hoặc phản hồi trống. Văn bản là lý do từ chính engine. |
application_fail |
status: 0 và error, không có gì khác |
Không thể phân giải tên máy chủ: could not resolve <host>: <reason>. Không có engine nào chạy, và ở chế độ Auto không có meta. Thử lại sẽ không thay đổi kết quả cho đến khi DNS thay đổi. |
application_fail |
Vòng lặp chuyển hướng, theo góc nhìn của hàng thứ năm:
{
"error": "Number of redirects hit maximum amount",
"total_time": 0.808
}
Trên POST /api/proxy/, một lệnh gọi hết số lần thử sẽ mang error: Download maxTry limit reached cùng một attemptReport chứa số lần đếm (xem API Errors). Trên POST /api/auto/, một ladder đã chạy và thất bại sẽ mang status, error, attempts, một attemptReport chứa các nguyên nhân, và meta.rung được đặt thành fail.
X-FourA-Credits báo cáo công việc đã thực hiện, ngay cả khi thất bại. Hệ thống thanh toán chỉ tính success, do đó không có cấu trúc thất bại nào ở trên bị tính phí.
Thành Công Phụ Thuộc Vào validate
Nếu không có validate, API chỉ đánh dấu một request là success khi mục tiêu trả về HTTP 200.
Khi có validate, kết quả thành công sẽ tuân theo các quy tắc bạn đã khai báo. Nếu bạn thông báo cho API rằng 200 và 403 đều được chấp nhận cho một request nhất định, mã 403 trả về sẽ được tính là success. Phần body vẫn được gửi đến bạn mà không thay đổi.
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://target.example/feed",
"validate": {
"status": { "accept": [200, 403] }
}
}'
Trong lệnh gọi này, phản hồi 403 được tính là success và được tính phí như một request. Phản hồi 500 được tính là application_fail và không bị tính phí.
Logic tương tự áp dụng cho validate.headers và validate.data. Bất kỳ phản hồi nào mà engine chấp nhận theo các quy tắc của bạn đều được trả về dưới dạng success bất kể trạng thái HTTP nào.
Có một câu trả lời không bao giờ là success, dù có hoặc không có validate: một phản hồi HTTP 200 có phần body là trang kiểm tra bot mà FourA nhận diện, chẳng hạn như tác vụ xác minh hình ảnh hoặc trang chỉ yêu cầu trình duyệt chạy JavaScript, hoặc trang từ chối mà một trang web phân phát kèm HTTP 200. Request đó là application_error và không bị tính phí. Phần body vẫn được gửi đến bạn mà không thay đổi, và header X-FourA-Check-Page sẽ nêu rõ tên trang.
Tác động đến tính phí
| Kết quả | Tính phí | Tính vào hạn mức |
|---|---|---|
success |
Có | Có |
application_error |
Không | Không |
application_fail |
Không | Không |
client_error |
Không | Không |
rate_limit |
Không | Không |
service_error |
Không | Không |
service_fail |
Không | Không |
Chỉ những request phân phát thành công dữ liệu bạn yêu cầu mới bị tính phí. Lỗi từ phía FourA, phía mục tiêu hoặc từ chính phía bạn đều hoàn toàn miễn phí.
Bảng này đề cập đến credit. Lưu lượng premium được tính riêng biệt với credit: một request đã thử một exit premium sẽ tính lưu lượng mà lần thử đó đã truyền tải, bất kể kết quả ra sao, vì exit đó đã được sử dụng trong mọi trường hợp. Một lần thử vẫn đang chạy khi một exit khác đã phản hồi sẽ bị dừng ngay lập tức, và lưu lượng nó đã truyền tải cho đến thời điểm đó cũng được tính.
Lưu lượng standard cũng không phụ thuộc vào kết quả: trên gói có giới hạn băng thông, lưu lượng của mọi request đều được tính vào giới hạn đó. Một request bị từ chối bởi một trong các giới hạn trong gói của bạn sẽ không bị tính lưu lượng.
Đường hầm sử dụng cùng hệ thống thuật ngữ
Một đường hầm qua cổng proxy cũng kết thúc bằng một trong các kết quả này, do đó một bộ nhãn bao hàm cả hai sản phẩm. Chỉ có năm trong số bảy kết quả có thể xảy ra, vì hai kết quả target yêu cầu FourA phải nhìn thấy câu trả lời của mục tiêu, trong khi câu trả lời của một đường hầm lại là lưu lượng mã hóa của chính bạn.
| Kết quả | Đối với đường hầm, điều này có nghĩa là |
|---|---|
success |
Đường hầm đã mở và công cụ của bạn đã nhận được nó. |
client_error |
FourA sẽ không mở đường hầm đó: một địa chỉ riêng tư hoặc dành riêng, hoặc một cổng mà hệ thống không hỗ trợ. |
rate_limit |
Đã đạt đến một trong các giới hạn trong gói của bạn (số đường hầm mở cùng lúc, số lần mở đường hầm mỗi phút, lưu lượng standard trong kỳ, lưu lượng premium mà bạn không có), hoặc chính cổng đó đã đạt hết công suất hoặc tốc độ mở. |
service_error |
FourA không có exit khả dụng cho nội dung bạn yêu cầu. Thường chỉ là tạm thời. |
service_fail |
Không thể tiếp cận mục tiêu thông qua bất kỳ exit nào FourA đã thử: lỗi DNS, timeout, kết nối bị từ chối. |
application_error |
Không bao giờ xảy ra trên đường hầm. |
application_fail |
Không bao giờ xảy ra trên đường hầm. |
Một lần từ chối cũng đi kèm lý do ngắn gọn, và dashboard hiển thị lý do đó theo thuật ngữ của bạn thay vì của chúng tôi. Tùy chọn mà FourA không thể đáp ứng sẽ được phản hồi 400 ngay trên chính kết nối và không ghi dòng nào, do đó nó hoàn toàn không xuất hiện tại đây.
| Lý do trên màn hình | Giới hạn bị chạm |
|---|---|
| port not in plan | Gói cước của bạn không bao gồm proxy port này |
| tunnels at once | Mọi tunnel mà gói của bạn cho phép cùng lúc đều đang được sử dụng |
| openings per minute | Số lượt mở tunnel trong phút này của gói cước đã hết |
| traffic used up | Lưu lượng traffic trong chu kỳ này của gói cước đã hết |
| premium not available | Traffic cao cấp hiện không khả dụng trên gói của bạn |
| port was full | Bản thân port đã đạt giới hạn dung lượng hoặc tốc độ mở. Hãy thử lại sau giây lát. |
| port not served | FourA không mở tunnel tới port đó |
| private address | Không thể tiếp cận các địa chỉ riêng tư và dành riêng |
Không có khoản phí nào của tunnel được tính bằng credit, vì tunnel không có request nào để trừ phí. Thay vào đó, port sẽ đo lường theo byte. Xem Cách Gói Cước Của Bạn Được Đo Lường.
Đọc Kết Quả trong Dashboard
Mọi request mà API key của bạn thực hiện đều xuất hiện trên bảng tin Activity cùng với nhãn kết quả tương ứng. Các trang Metrics và Overview tổng hợp trường này cho biểu đồ donut và timeline.
Khi bạn lọc Activity theo kết quả, bạn cũng có thể tập trung vào một endpoint duy nhất (Auto, Single, Proxy Finder, Browser) để xem liệu một loại lỗi có xảy ra riêng ở endpoint đó hay không. Chuyển mục Product của trang sang Proxy và các nhãn kết quả tương tự sẽ lọc tunnel của bạn.
Heuristic Thử Lại
Chính sách thử lại cơ bản dựa trên kết quả:
| Kết quả | Có an toàn để thử lại? | Khi nào |
|---|---|---|
success |
k/d | Bạn đã có response. |
application_error |
Đôi khi | Đọc error body từ mục tiêu. Một số là tạm thời, phần lớn thì không. Nếu X-FourA-Check-Page được thiết lập, trang web đã trả về trang kiểm tra: hãy gửi URL tới Auto, nơi xử lý trang kiểm tra như một bước cần vượt qua chứ không phải câu trả lời. |
application_fail |
Đôi khi | Nếu trang mục tiêu đang giới hạn rate limit của bạn, hãy giảm tốc độ. Nếu trang đang chặn bạn, hãy chuyển sang endpoint Proxy hoặc Browser. |
client_error |
Không | Request sẽ thất bại tiếp theo cùng một cách. Hãy sửa dữ liệu đầu vào. |
rate_limit |
Tùy trường hợp | Tuân thủ thời gian chờ mà response cung cấp: Retry-After, retry_after_seconds, hoặc retryAfter. Với plan_limit_browser_daily, tạm dừng cho đến nửa đêm UTC; với plan_limit_credits hoặc plan_limit_bandwidth, tạm dừng cho đến resets_at; với plan_limit_feature hoặc plan_limit_premium, hãy thay đổi request. |
service_error |
Có | Exponential backoff ngắn. |
service_fail |
Có | Tương tự như service_error. |
Liên quan
- Lỗi API: Các response lỗi ở cấp độ HTTP
- Cổng Proxy: Các mã trạng thái trả về khi tunnel từ chối
- Rate Limit: Những nguyên nhân kích hoạt
rate_limit, và hai định dạng phản hồi của nó - Số liệu (Metrics): Nơi bạn xem kết quả được phân tích chi tiết
- Nhật ký hoạt động: Lịch sử kết quả của từng request