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 phát hiện proxy. Sử dụng endpoint này để kiểm tra xem lưu lượng gửi đi của bạn có đang đi qua proxy hay không trước khi bắt đầu gửi các request qua FourA.

Request

GET /inspect

Endpoint này ở chế độ 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"
}

Trường cấp cao nhất

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

proxyDetection

Trường Kiểu Mô tả
isProxy boolean True nếu phát hiện thấy các header proxy phía client
proxyType string Một trong các giá trị: transparent, anonymous, distorting, none
anonymityLevel string Một trong các giá trị: transparent, anonymous, none
confidence string Mức độ tin cậy 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 văn bản dễ hiểu

proxyChain

Trường Kiểu Mô tả
originalClientIp string Giống với clientIp ở cấp cao nhất
proxyChain string[] Danh sách IP proxy nằm 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ả mạo đến đích
none Không thấy header proxy: kết nối trực tiếp, hoặc một proxy không gửi header nào

Khi nào nên dùng endpoint này

  • Xác nhận lưu lượng outbound của bạn không đi qua proxy doanh nghiệp hoặc đường hầm ngoài ý muốn.
  • Gỡ lỗi lý do IP thật của bạn xuất hiện trong log của trang web đích ngay cả khi bạn nghĩ mình đã ẩn danh.
  • Xác minh proxy dân cư hoặc proxy xoay vòng đang che giấu địa chỉ gốc 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 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 rộng rãi. Nếu bạn gọi endpoint nhiều hơn vài lần mỗi giây từ cùng một IP, request sẽ bị điều tiết (throttling).
  • Response chỉ phản ánh các header và IP. Endpoint không thể phát hiện proxy cao cấp ẩn danh hoàn toàn (elite proxy) loại bỏ mọi header proxy.

Liên quan

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