API说明
下发代理:默认代理分组
根域名现在进入 UI,下发代理请使用显式 API 参数。
GET /?api=1 HTTP/1.1 Host: your-domain.com
下发代理:指定代理分组
只有“运行模式作用分组”会按固定/智能模式改写和统计;其它分组始终原始下发。
GET /?api=1&g=2 HTTP/1.1 Host: your-domain.com
下发成功响应
客户只读取 proxy 即可。
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{"status":"ok","proxy":"host:port:user:pass"}
反馈:代理可用
反馈只推荐 POST JSON。客户只需要提交下发拿到的 proxy 和 available;后台会根据下发记录自动归属代理分组和时间窗口。
POST /?action=feedback HTTP/1.1
Host: your-domain.com
Content-Type: application/json
{
"proxy": "host:port:user:pass",
"available": 1
}
反馈:代理不可用
不可用时 available 传 0。
POST /?action=feedback HTTP/1.1
Host: your-domain.com
Content-Type: application/json
{
"proxy": "host:port:user:pass",
"available": 0
}
反馈响应
tracked=true 表示已进入智能统计;tracked=false 表示未匹配到下发记录或该下发不参与统计,只保存原始反馈。
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{"status":"ok","tracked":true,"matched":true,"group_id":6,"region":"PL","window_key":"23:30"}
错误响应
参数缺失或格式错误会返回 error。
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{"status":"error","message":"missing proxy"}
API endpoint: /?api=1(代理分组 1) | /?api=1&g=N(代理分组 N) | legacy: /?N