Tài liệu › Tham chiếu API › Endpoint Inspect

Endpoint Inspect

Một endpoint chẩn đoán công khai trả về IP client của bạn và thông tin chi tiết về việc phát hiện proxy. Hãy sử dụng nó để xác minh xem lưu lượng outbound của bạn có đang đi qua một proxy hay không trước khi bạn bắt đầu gửi các request qua FourA.

Request

GET /inspect

Endpoint này là công khai. Không cần API key, không cần header X-API-Key.

curl https://eu.api.foura.ai/inspect

Response

{
  "clientIp": "203.0.113.42",
  "proxyDetection": {
    "isProxy": false,
    "proxyType": "none",
    "anonymityLevel": "none",
    "confidence": "medium",
    "detectedHeaders": [],
    "explanation": "Direct connection (no client-side proxy detected). Note: Elite proxies cannot be ruled out without additional data."
  },
  "proxyChain": {
    "originalClientIp": "203.0.113.42",
    "proxyCount": 0,
    "hasPrivateIps": false
  },
  "timestamp": "2026-04-29T08:07:04.683Z"
}

Các trường cấp cao nhất

Trường Kiểu dữ liệu Mô tả
clientIp string IP client gốc (địa chỉ ngoài cùng bên trái trong chuỗi forwarded)
proxyDetection object Phát hiện proxy và phân tích mức độ ẩn danh
proxyChain object Phân tích chi tiết chuỗi IP phía client
timestamp string Nhãn thời gian ISO 8601 khi request được kiểm tra

proxyDetection

Trường Kiểu dữ liệu Mô tả
isProxy boolean True nếu phát hiện các header proxy phía client
proxyType string Một trong các giá trị: transparent, anonymous, distorting, elite, none
anonymityLevel string Một trong các giá trị: transparent, anonymous, elite, none
confidence string Độ tin cậy của việc phát hiện: high, medium, hoặc low
detectedHeaders string[] Tên các header báo hiệu có proxy (ví dụ: via, forwarded)
explanation string Tóm tắt kết quả bằng tiếng Anh đơn giản

proxyChain

Trường Kiểu dữ liệu Mô tả
originalClientIp string Giống như clientIp ở cấp cao nhất
proxyChain string[] Danh sách các IP proxy giữa bạn và FourA, nếu có
proxyCount number Số lượng proxy được phát hiện trong chuỗi (0 = trực tiếp)
via string[] Nội dung của header Via, nếu có
hasPrivateIps boolean True nếu có bất kỳ IP riêng tư/nội bộ nào xuất hiện trong chuỗi

Các loại Proxy

Loại Ý nghĩa
transparent Chuyển tiếp IP thật của bạn và tự nhận diện là một proxy
anonymous Ẩn IP thật của bạn nhưng tự nhận diện là một proxy
distorting Gửi một IP client giả đến đích
elite Không có header proxy, trông giống như một kết nối trực tiếp
none Không phát hiện proxy phía client

Khi nào nên sử dụng

  • Xác nhận lưu lượng outbound của bạn không đi qua một proxy doanh nghiệp hoặc VPN ngoài ý muốn.
  • Debug lý do tại sao IP thật của bạn xuất hiện trong log của trang web mục tiêu ngay cả khi bạn nghĩ mình đang ẩn danh.
  • Xác minh xem proxy dân cư (residential) hoặc proxy xoay (rotating) có đang che giấu nguồn của bạn trước khi bạn gửi các request trả phí qua FourA.

Endpoint này kiểm tra kết nối của bạn tới FourA. Nó không kiểm tra mạng lưới proxy của chính FourA. Để xác minh request được định tuyến qua FourA đến từ IP nào, hãy sử dụng Proxy endpoint và đọc response.

Giới hạn

  • Không yêu cầu xác thực.
  • Áp dụng rate limit công khai khá rộng rãi. Nếu bạn gọi nó nhiều hơn vài lần mỗi giây từ cùng một IP, kết nối có thể bị giới hạn tốc độ (throttling).
  • Response chỉ phản ánh các header và IP. Nó không thể phát hiện một elite proxy hoàn toàn trong suốt đã loại bỏ tất cả các header proxy.

Tài liệu liên quan

Cập nhật: 29 tháng 4, 2026
← Rate Limit Kết quả Request →