httpdns

概述

关于腾讯云移动解析HTTPDNS

腾讯云移动解析HTTPDNS基于HTTP协议向腾讯云的DNS服务器发送域名解析请求，替代了基于DNS协议向运营商Local DNS发起解析请求的传统方式，可以避免Local DNS造成的域名劫持和跨网访问问题，解决移动互联网服务中域名解析异常带来的困扰。

了解更多腾讯云移动解析相关内容请到腾讯云移动解析产品页。

注册及购买

注册

您可以在这里注册腾讯云账号，详情参见注册腾讯云教程。

如果遇到产品相关问题，您可咨询在线客服寻求帮助。

免费额度

在腾讯云移动解析产品控制台开通移动解析HTTPDNS且服务正常启用中的用户，系统每个月（按月计算）均提供一定额度的免费流量包，根据用户类型不同提供的额度不同：

  • 针对DNSPod解析域名，提供600万次/月的免费解析次数额度；
  • 针对非DNSPod解析域名，提供300万次/月的免费解析次数额度；

了解更多购买信息

了解流量包价格详情请查看腾讯云移动解析产品文档。

您可以自行购买流量包进行抵扣，系统在计费时会优先抵扣流量包，超出部分再继续按照0.04元/万次单价进行计费。

了解腾讯云移动解析更多购买指南请参考腾讯云移动解析产品购买指南

插件接口

initConfig

初始化方法

initConfig({params}, callback(ret))

Params属性

属性名称 类型 默认值 必填 说明
dnsIp string 无 是 HTTPDNS 服务器 IP。HTTP 协议服务地址为 119.29.29.98，HTTPS 协议服务地址为 119.29.29.99
dnsId int 无 是 授权ID，腾讯云控制台申请后可直接在控制台查看
dnsKey string 无 否 加密密钥，加密方式为 AES、DES 时必传。腾讯云控制台申请后可直接在控制台查看，用于域名解析鉴权
token string 无 否 加密 token，加密方式为 HTTPS 时必传
encryptType string "0" 否 点击阴影区域是否自动隐藏弹出菜单
debug bool false 否 是否开启Debug日志，YES：开启，NO：关闭。建议联调阶段开启，正式上线前关闭
minutesBeforeSwitchToMain int 10 否 可选，设置切回主ip间隔时长，默认10分钟
retryTimesBeforeSwitchServer int 3 否 可选，切换ip之前重试次数, 默认3次
enableReport bool false 否 是否开启解析异常上报，默认NO，不上报
timeout int 2000 否 可选，超时时间，单位ms，如设置0，则使用默认值2000ms
httpOnly bool false 否 可选，是否仅返回 httpDns 解析结果。默认 false，即当 httpDns 解析失败时会返回 LocalDNS 解析结果，设置为 true 时，仅返回 httpDns 的解析结果
addressType string "0" 否 // 指定返回的ip地址类型，默认为 HttpDnsAddressTypeAuto sdk自动检测

callback(ret)

ret：

​ 类型：JSON 对象

​ 内部字段：

{
    status:true/false                  //布尔类型；true初始化成功，false初始化失败
}

示例代码

var demo = api.require('httpdns');
    demo.initConfig({
        dnsIp: "119.29.29.98",
        dnsId: 69753,
        dnsKey: "******",
        token: "******",
        encryptType: 0,
        debug: false
    },function(ret, err){
        if(ret.status){
            api.toast({
                msg: ret.status.toString(),
                location: 'middle'
            });
        }else{
            api.toast({
                msg: "失败",
                location: 'middle'
            });
        }
        
    });

WGGetHostByName

域名解析接口，单个（返回单个 IP）

WGGetAllHostsByNames({params})

Params属性

属性名称 类型 默认值 必填 说明
domain string 无 是 待解析的域名

return

ret：

​ 类型：数组对象

​ 内部字段：

[ip值，0]

示例代码

var demo = api.require('httpdns');
var ret = demo.WGGetHostByName({
  domain: "dnspod.com"
});

WGGetHostsByNames

域名解析接口，批量查询（返回单个 IP）

WGGetAllHostsByNames({params})

Params属性

属性名称 类型 默认值 必填 说明
domains string[] 无 是 待解析的域名列表

return

ret：

​ 类型：JSON 对象

​ 内部字段：

{
 domainA:[],
 domainB:[]
}

示例代码

var demo = api.require('httpdns');
var ret = demo.WGGetHostsByNames({
  domain: ["dnspod.com","www.qq.com"]
});

WGGetAllHostsByNames

域名解析接口，批量查询（返回所有 IP）

WGGetAllHostsByNames({params})

Params属性

属性名称 类型 默认值 必填 说明
domains string[] 无 是 待解析的域名列表

return

ret：

​ 类型：JSON 对象

​ 内部字段：

{
 domainA:{
     ipv4:[],
     ipv6:[]
 },
 domainB:{
     ipv4:[],
     ipv6:[]
 }
}

示例代码

var demo = api.require('httpdns');
var ret = demo.WGGetAllHostsByNames({
  domain: ["dnspod.com","www.qq.com"]
});
是否仍需要帮助？ 请保持联络！
最后更新于 2026/04/24