Check Proxy

Usage Instructions

Proxy detection API. Supports checking both saved proxies and custom proxy configurations.

Request Instructions

POST /api/v1/proxy/check

Request Parameters

Parameter	Type	Required	Description
proxy_id	string	No	Proxy ID, can be obtained from the proxy list.
host	string	No	IP or domain. Required when proxy_id is not provided.
port	int	No	Port. Required when proxy_id is not provided.
user	string	No	Username
password	string	No	Password
ip_scan_channel	string	No	Proxy detection channels, supporting: ip2location, ipapi. Defaults to ip2location if omitted.

Request Example 1

json Copy

{
    "ip_scan_channel": "ip2location",
    "host": "1xx.xx.xx.xxx",
    "port": "xxxx",
    "user": "Oxxxxx6",
    "password": "3xxxxxx1"
}

Request Example 2

json Copy

{
    "proxy_id": "aDvBj"
}

Response Example (Success)

json Copy

{
    "code": 200,
    "data": {
        "success": true,                    // Detection result. true indicates success; false indicates failure.
        "ip": "64.188.10.193",              // Detected public IP address.
        "country": "us",                    // Country code.
        "region": "new york",               // Region or state/province.
        "city": "buffalo",                  // City.
        "timezone": "America/New_York",     // Time zone.
        "longitude": "-78.882486",          // Longitude.
        "latitude": "42.878243",            // Latitude.
        "tips": "",                         // Additional information or error message.
        "user": "xxxxx",                    // Proxy username.
        "password": "xxxxx"                 // Proxy password.
    },
    "message": "Success"
}

Response Example (Failed)

json Copy

{
    "code": 200,
    "data": {
        "success": false,
        "ip": "",
        "country": "",
        "region": "",
        "city": "",
        "timezone": "",
        "longitude": "",
        "latitude": "",
        "tips": "Connection test failed! Please ensure the proxy information is correct and the IP is available.",
        "user": "xxxxx",
        "password": "xxxxxx"
    },
    "message": "Success"
}

Modify Proxy

Groups

Last modified: 2026-06-16Powered by

Outline