检测临时代理

POST

http://local.zhongyibrowser.com:39025/api/v1/proxies/check

最后修改时间：2026-07-21 07:29:35

检测请求体中的 custom 或 api 临时代理配置，不创建代理，也不更新任何已保存代理。API 模式会先访问提取地址解析当前 IPv4 和端口，再检测该连接；代理连接失败或超时属于正常检测结果，HTTP 200 响应中的 status 为 unavailable。本接口只需要 Local API Key，不依赖客户端后端登录态。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "mode": "custom",
    "config": {
        "protocol": "http",
        "ip_protocol": "ipv4",
        "host": "string",
        "port": 1,
        "username": "string",
        "password": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://local.zhongyibrowser.com:39025/api/v1/proxies/check' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "custom",
    "config": {
        "protocol": "http",
        "ip_protocol": "ipv4",
        "host": "string",
        "port": 1,
        "username": "string",
        "password": "string"
    }
}'

返回响应

🟢200

application/json

临时代理检测结果

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "mode": "custom",
        "status": "available",
        "endpoint": {
            "protocol": "http",
            "ip_protocol": "ipv4",
            "host": "string",
            "port": 1
        },
        "checked_at": "2019-08-24T14:15:22.123Z",
        "latency_ms": 0
    }
}

🟠400

🟠401

🟠403

🟠422

🔴500

修改于 2026-07-21 07:29:35

删除代理

检测已保存代理