CloudFront 优选 IP 查询
更新于 2026-11-18
通过 CloudFront 接口获取移动、联通、电信线路的优选地址。
接口信息
/api/cf2dns/get_cloudfront_ip,支持 GET / POST,返回 JSON。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| key | 是 | 1–50 位字母数字令牌,区分大小写,使用对应 CDN 的令牌 |
| type | 是 | v4 或 v6 |
免费与付费使用同一接口。付费令牌每次调用均检查停用和到期状态,包括缓存命中时。
请求示例
以下域名和令牌仅用于演示,请替换为实际站点及自己的令牌。
curl --request POST 'https://example.com/api/cf2dns/get_cloudfront_ip' --data-urlencode 'key=YOURTOKEN' --data-urlencode 'type=v4'
返回参数
{"status":true,"code":200,"msg":"查询成功","info":{"CM":[],"CU":[],"CT":[]}}
info 内三组数组对应移动、联通、电信。空数组表示当前无分配结果;成功并不保证每个线路都有地址。
错误处理
参数缺失或无效可能返回 status=false, code=500, info=""。授权失败保留历史组合 status=true, code=500,其 info 为三个空数组。统一检查 code 和 msg,不要仅依据 status。
使用建议
不要把私人令牌发布到截图、代码仓库或工单正文。到期时前往授权管理教程续费。