创建代理

POST

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

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

创建 custom 或 api 代理并返回创建后的完整详情。API 代理只需提供提取地址，Local API 会在本机解析当前 IP 和端口；integ、syt 不能通过该接口创建。用户名、密码和提取地址属于敏感字段，不应写入调用方日志。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "name": "string",
    "remark": "string",
    "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' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "remark": "string",
    "mode": "custom",
    "config": {
        "protocol": "http",
        "ip_protocol": "ipv4",
        "host": "string",
        "port": 1,
        "username": "string",
        "password": "string"
    }
}'

返回响应

🟢201

application/json

创建后的代理详情

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "id": "string",
        "name": "string",
        "remark": "string",
        "status": "unchecked",
        "checked_at": "2019-08-24T14:15:22.123Z",
        "browser_count": 0,
        "is_expired": true,
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "mode": "custom",
        "config": {
            "protocol": "http",
            "ip_protocol": "ipv4",
            "host": "string",
            "port": 1,
            "username": "string",
            "password": "string"
        },
        "browser_ids": [
            "env_01JABCDEF1234567890"
        ]
    }
}

🟠400

🟠401

🟠403

🟠422

🔴500

🔴502

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

获取代理列表

获取代理详情