接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
action | get | query | 可选 | — | — | 操作:get 获取随机可用代理(默认);list 分页列表;stats 统计信息;health 健康检查;openapi 接口规范 |
type | — | query | 可选 | http | — | 代理类型:http / https / socks / socks4 / socks5 / all,默认 all |
count | — | query | 可选 | 10 | — | 返回数量 1-100,默认 1;超过 100 会截断并返回 truncated=true |
format | json | query | 可选 | — | — | 输出格式:json / txt(action=get 时可用),默认 json |
country | — | query | 可选 | 中国 | — | 按国家/地区过滤(匹配 country 字段,如「中国」「美国」),默认不过滤 |
page | 1 | query | 可选 | — | — | 分页页码,action=list 时可用,默认 1 |
limit | 20 | query | 可选 | — | — | 每页数量 1-100,action=list 时可用,默认 20 |
sort | — | query | 可选 | speed | — | 排序字段:speed 延迟 / score 或 success 成功率 / updated 最近更新 / id,默认 speed |
anon | — | query | 可选 | elite | — | 匿名级别过滤:elite 高匿 / anonymous 匿名 / transparent 透明,默认不过滤 |
min_score | — | query | 可选 | 0.5 | — | 最低成功率 0-1,按 success/(success+fail) 计算,默认不过滤 |
min_success | — | query | 可选 | 3 | — | 最少历史成功次数,默认不过滤 |
q | — | query | 可选 | 香港 | — | 关键词,匹配地址、国家、地区、网络,action=list 时可用 |
order | — | query | 可选 | desc | — | 排序方向:asc / desc,默认 asc,action=list 时可用 |