检测已保存代理

POST

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

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

检测当前用户、当前团队有权访问的已保存代理，支持 custom、api、integ、syt 四种模式，并更新该代理的 status 和 checked_at。同一代理的并发检测复用一个任务。API 代理会先检测当前 endpoint；失败时重新访问提取地址，必要时保存新的 endpoint 后再检测。代理连接失败或提取失败均作为 status=unavailable 的正常检测结果返回。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://local.zhongyibrowser.com:39025/api/v1/proxies//check' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200

application/json

已保存代理检测结果

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "proxy_id": "proxy_01JABCDEF1234567890",
        "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

🟠404

🔴500

🔴502

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

检测临时代理

替换代理绑定环境