动态代理 API：国家、州和城市查询

调用本接口获取动态住宅、动态机房和海外手机代理可用的地区调用值，再把这些值用于动态代理提取。

请求

GET /api/user_get_location_list

请求头：Api-Token: YOUR_API_KEY。可选 Accept-Language: zh-CN、zh-HK、en。API 域名请使用网页端「API 接口」显示的地址。

只有 wifi 支持国家 → 州/省 → 城市。dat、dc 和 5g 只支持国家。返回地区列表不等于保证该地区每次都能立即连接成功。

分层查询示例

以下 Bash/curl 示例假设 DFIP_API_BASE 已设置为实际域名，DFIP_API_KEY 已安全注入环境。

# 1. Read countries.
curl --silent --show-error --get \
  "$DFIP_API_BASE/api/user_get_location_list" \
  -H "Api-Token: $DFIP_API_KEY" \
  --data-urlencode 'type=wifi' --data-urlencode 'level=country'

# 2. Replace COUNTRY_VALUE with a returned country value.
curl --silent --show-error --get \
  "$DFIP_API_BASE/api/user_get_location_list" \
  -H "Api-Token: $DFIP_API_KEY" \
  --data-urlencode 'type=wifi' --data-urlencode 'level=state' \
  --data-urlencode 'country=COUNTRY_VALUE'

# 3. Replace STATE_VALUE with a returned state value.
curl --silent --show-error --get \
  "$DFIP_API_BASE/api/user_get_location_list" \
  -H "Api-Token: $DFIP_API_KEY" \
  --data-urlencode 'type=wifi' --data-urlencode 'level=city' \
  --data-urlencode 'country=COUNTRY_VALUE' \
  --data-urlencode 'state=STATE_VALUE'

请保留原始调用值并做 URL 编码，不要根据中文显示名自行拼写。尤其是城市，使用 list[].value，不要替换成 list[].code。

响应字段

成功响应为 {"code":0,"msg":"ok","data":{...}}。

接口返回当前筛选的完整列表，没有服务端 page / page_size 分页。大量结果可用 keyword 筛选，或由调用端分页展示。

错误码

下一步：动态代理提取。接入指南 · English version