动态代理 API：提取连接信息与参数说明
使用表单 API Key 提取动态代理，了解地区、协议、会话、维持时长和输出格式。
本接口生成可用于代理软件的连接字符串，支持动态住宅、动态机房和海外手机代理。返回的主机可能是接入网关，并不一定是最终出口 IP；生成多个连接字符串也不保证得到相同数量的独立出口 IP。
请求与鉴权
GET /api/user_get_ip_list 或 POST /api/user_get_ip_list
凭证必须放在 token 参数中。POST 使用 application/x-www-form-urlencoded 表单，当前接口不读取 JSON 请求体，也不从 Api-Token 请求头读取凭证。建议优先使用 POST 表单。
参数表
| 参数 | 默认值 | 说明 |
|---|---|---|
token | 无 | 必填，个人中心 API Key |
type | wifi | wifi 动态住宅、dat/dc 动态机房、5g 海外手机 |
qty | 1 | 生成数量，1–500；不要依赖服务端对小于 1 的数值纠正 |
protocol | http | http、https、socks5，具体类型是否开通该协议以当前配置为准 |
country | 空 | 目标出口国家，使用地区查询返回的 value；不填表示不指定国家 |
state | 空 | 州/省，仅 wifi；与 country 一起使用 |
city | 空 | 城市，仅 wifi；使用城市的 value，并带上其国家和州 |
area | 自动 | 接入点区域，可传 sg、us、cn；省略时自动选择，可能回退到其他可用接入点 |
is_rand | 0 | 0 生成会话标识；1 使用随机模式 |
ip_duration | 0 | 维持时长，单位分钟；0 不指定，正数须为页面当前允许的选项 |
format | json | json、txt，兼容 text；建议程序接入使用 json |
output | 0 | 连接字符串排列方式，见下表 |
area 选择连接到哪个入口，country/state/city 选择目标出口地区，二者用途不同。ip_duration > 0 不能与 is_rand=1 同时使用。固定会话模式及维持时长不应被理解为永久固定 IP。
| output | 字符串排列 |
|---|---|
0 | username:password@host:port |
1 | host:port:username:password |
2 | username:password:host:port |
3 | host:port@username:password |
这些字符串不自带协议前缀。使用时应在软件中选择与请求一致的协议。
POST 示例
先配置实际 DFIP_API_BASE 并安全注入 DFIP_API_KEY。以下示例生成 1 条不限定国家的动态住宅连接；若需定位，添加从地区接口取得的参数。
curl --silent --show-error --max-time 30 \
"$DFIP_API_BASE/api/user_get_ip_list" \
-H 'Accept-Language: zh-CN' \
--data-urlencode "token=$DFIP_API_KEY" \
--data-urlencode 'type=wifi' \
--data-urlencode 'protocol=http' \
--data-urlencode 'qty=1' \
--data-urlencode 'is_rand=0' \
--data-urlencode 'ip_duration=0' \
--data-urlencode 'format=json' \
--data-urlencode 'output=0'
响应结构示例，所有连接信息均为占位值：
{
"code": 0,
"msg": "ok",
"data": ["EXAMPLE_USER:[email protected]:12345"]
}
data 是字符串数组，不是对象数组。format=txt 时成功响应每行一条；失败响应可能只有提示文字。因此需要可靠错误处理时使用 JSON，并检查 code。
随机、会话与使用成本
每次调用固定会话模式会生成新的会话标识；重复调用提取接口可能得到新的连接信息，不是对原结果的幂等读取。保存需要复用的连接信息，避免不必要地持续重新提取。
账户有效余额需要大于 0；共享余额子账号按共享账户余额检查。新用户可使用的代理类型可能受限。提取连接信息不代表后续使用免费，实际代理流量按账户的产品规则计费。
常见错误
| code | 原因或处理 |
|---|---|
1001 | qty 超过 500 |
1002 | type 无效 |
1003 | protocol 无效 |
1004 | 当前类型未开通所选协议 |
1005 / 1006 | 接入点区域或可用入口问题，检查配置或联系客服 |
1007 / 1008 | Key 无效、过期、禁用，或账号不可用 |
1010 | 维持时长不是当前支持的选项 |
1011 | 随机模式与正数维持时长冲突 |
4002 | 当前新用户账户不支持所选代理类型 |
4003 | 可用余额不足，需要充值 |
业务错误可能返回 HTTP 200。新用户限制也可能直接返回 JSON，因此即使请求 txt，也应处理异常响应格式。