代理与指纹管理
代理池、代理检测与分配,以及环境指纹读取、设置和校验接口。
接口目录版本:3.1.12.180 · 目录生成时间:2026-06-21 16:55:02
添加代理配置
查询全局代理池
删除全局代理池代理
新增全局代理池代理
更新全局代理池代理
检测代理连通性
批量分配代理到环境
解析代理地区时区语言
查询指纹模板列表
读取环境指纹
设置环境指纹
随机化环境指纹
校验环境指纹
导入全局代理池代理
导出全局代理池代理
添加代理配置
/api/v1/session/proxy/add
Path:/api/v1/session/proxy/add
Method:POST
Content-Type:application/json
接口描述:向候鸟客户端本地代理库添加一条可复用代理配置。此接口只新增代理配置,不会自动绑定到某个环境;如需绑定环境代理,请使用 /api/v1/session/proxy/update。
请求参数
参数名称 类型 必传 样例串/默认值 说明
Proxy_Type string 是 HTTP 代理类型,如 HTTP、HTTPS、SOCKS5、noproxy
Proxy_Ip string 是 127.0.0.1 代理服务器地址
Proxy_Port string 是 1080 代理端口
Proxy_Username string 否 admin 代理用户名
Proxy_Password string 否 password 代理密码
Is_CheckProxy bit 否 0 是否添加前检测代理,1 检测,0 不检测
TimeZone string 否 US/Alaska -09:000 代理关联时区
CountryCode string 否 US 代理关联国家码
请求示例
{
"Proxy_Type": "HTTP",
"Proxy_Ip": "127.0.0.1",
"Proxy_Port": "1080",
"Proxy_Username": "",
"Proxy_Password": "",
"Is_CheckProxy": 0
}
执行成功返回
{
"message": "Add Proxy Success",
"code": 0,
"data": null
}
请求示例
{
"Proxy_Type":"HTTP",
"Proxy_Ip":"127.0.0.1",
"Proxy_Port":"1080",
"Proxy_Username":"",
"Proxy_Password":"",
"Is_CheckProxy":0
}
接口目录 ID:api_049