DNS 域名解析

正常 NEW

DNS 域名解析查询服务，支持常见记录类型查询、批量查询与反向解析（PTR）。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1702次

¥ 0.001 / 次

按次计费

购买次数包更优惠，低至 0.0008 元/次

100次调用包 100 次调用 ¥0.0010 /次

500次调用包 500 次调用 ¥0.00095 /次省 5%

1000次调用包 1,000 次调用 ¥0.0009 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.00085 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0008 /次省 20%

健康检查

服务存活探测接口，用于负载均衡与可用性监控。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/dns/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息，健康检查固定为 pong
data	object	业务数据
data.version	string	服务版本号
data.time	string	服务器当前时间（UTC）
data.types_count	integer	支持的记录类型数量
data.batch_limit	integer	批量查询单次最大条数

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-23 11:59:37","version":"1.0","batch_limit":10,"types_count":15}}

记录类型列表

返回全部支持的 DNS 记录类型及说明。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/dns/types JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	类型列表
data.list[]	object	列表中的单条记录
data.list[].type	string	记录类型代码，可用于 resolve / batch 的 types 参数
data.list[].description	string	描述

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"type":"A","description":"IPv4 地址"},{"type":"AAAA","description":"IPv6 地址"},{"type":"CNAME","description":"规范名称 (别名)"},{"type":"MX","description":"邮件交换"},{"type":"NS","description":"域名服务器"},{"type":"TXT","description":"文本记录"},{"type":"SOA","description":"授权起始"},{"type":"PTR","description":"指针记录 (反向 DNS)"},{"type":"SRV","description":"服务记录"},{"type":"HINFO","description":"主机信息"},{"type":"NAPTR","description":"命名权威指针"},{"type":"CAA","description":"证书颁发机构授权"},{"type":"DNSKEY","description":"DNS 密钥"},{"type":"DS","description":"委托签名"},{"type":"TLSA","description":"TLS 认证"}],"total":15}}

DNS 解析

查询指定域名的 DNS 记录，支持按类型过滤与指定 DNS 服务器。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/dns/resolve JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
domain	string	是	待查询域名（支持国际化域名，最长 253 字符）
types	string	否	记录类型，逗号分隔字符串或数组；默认返回全部 15 种类型
type	string	否	types 的别名，两者等价；同时传入时以 types 为准
server	string	否	指定 DNS 服务器 IP，默认使用系统 DNS；指定后若该服务器不可达可能返回空记录
force	boolean	否	为 true 时跳过缓存，强制实时查询

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.domain	string	域名
data.ascii_domain	string	ASCII 域名
data.is_idn	boolean	是否为国际化域名
data.types	array	本次查询使用的记录类型列表；未指定 types 时为全部 15 种
data.types[]	string	类型
data.record_count	integer	记录数量
data.min_ttl	integer	本次结果中的最小 TTL（秒），无记录时为 0
data.records	object	DNS 记录集合，按记录类型分组，仅包含本次实际查到的类型（未查到的类型不会出现该键）；无记录时为空数组 []
data.records.A	array	A 记录列表
data.records.A[]	object	A 记录
data.records.A[].type	string	类型
data.records.A[].ttl	integer	缓存有效期（秒）
data.records.A[].ip	string	IP 地址
data.records.NS	array	NS 记录列表
data.records.NS[]	object	NS 记录
data.records.NS[].type	string	类型
data.records.NS[].ttl	integer	缓存有效期（秒）
data.records.NS[].target	string	目标主机
data.records.SOA	array	SOA 记录列表
data.records.SOA[]	object	SOA 记录
data.records.SOA[].type	string	类型
data.records.SOA[].ttl	integer	缓存有效期（秒）
data.records.SOA[].mname	string	主域名服务器
data.records.SOA[].rname	string	管理员邮箱
data.records.SOA[].serial	integer	序列号
data.records.SOA[].refresh	integer	刷新间隔（秒）
data.records.SOA[].retry	integer	重试间隔（秒）
data.records.SOA[].expire	integer	过期时间（秒）
data.records.SOA[].minimum-ttl	integer	最小 TTL（秒）
data.records.MX	array	MX 记录列表
data.records.MX[]	object	MX 记录
data.records.MX[].type	string	类型
data.records.MX[].ttl	integer	缓存有效期（秒）
data.records.MX[].pri	integer	优先级
data.records.MX[].target	string	目标主机
data.records.TXT	array	TXT 记录列表
data.records.TXT[]	object	TXT 记录
data.records.TXT[].type	string	类型
data.records.TXT[].ttl	integer	缓存有效期（秒）
data.records.TXT[].txt	string	TXT 记录内容
data.records.AAAA	array	AAAA 记录列表
data.records.AAAA[]	object	AAAA 记录
data.records.AAAA[].type	string	类型
data.records.AAAA[].ttl	integer	缓存有效期（秒）
data.records.AAAA[].ipv6	string	IPv6 地址
data.records.CNAME	array	CNAME 记录列表
data.records.CNAME[]	object	CNAME 记录
data.records.CNAME[].type	string	类型
data.records.CNAME[].ttl	integer	缓存有效期（秒）
data.records.CNAME[].target	string	指向的目标域名
data.records.PTR	array	PTR 记录列表（反向解析）
data.records.PTR[]	object	PTR 记录
data.records.PTR[].type	string	类型
data.records.PTR[].ttl	integer	缓存有效期（秒）
data.records.PTR[].target	string	反向解析得到的主机名
data.records.SRV	array	SRV 记录列表
data.records.SRV[]	object	SRV 记录
data.records.SRV[].type	string	类型
data.records.SRV[].ttl	integer	缓存有效期（秒）
data.records.SRV[].pri	integer	优先级，数值越小优先级越高
data.records.SRV[].weight	integer	权重
data.records.SRV[].port	integer	服务端口
data.records.SRV[].target	string	目标主机名
data.records.CAA	array	CAA 记录列表
data.records.CAA[]	object	CAA 记录
data.records.CAA[].type	string	类型
data.records.CAA[].ttl	integer	缓存有效期（秒）
data.records.CAA[].flags	integer	标志位
data.records.CAA[].tag	string	标签，如 issue / issuewild / iodef
data.records.CAA[].value	string	标签对应的值
data.records.{TYPE}	array	其他类型记录列表（HINFO / NAPTR / DNSKEY / DS / TLSA），按实际查到的类型分组
data.records.{TYPE}[]	object	其他类型记录
data.records.{TYPE}[].type	string	类型
data.records.{TYPE}[].ttl	integer	缓存有效期（秒）
data.records.{TYPE}[].value	string	记录原始内容
data.cached	boolean	是否命中缓存
data.queried_at	string	数据查询时间（UTC，ISO 8601）
data.elapsed_ms	integer	服务端处理耗时（毫秒）

请求示例

返回示例

{"msg":"success","code":200,"data":{"types":["A","AAAA","CNAME","MX","NS","TXT","SOA","PTR","SRV","HINFO","NAPTR","CAA","DNSKEY","DS","TLSA"],"cached":false,"domain":"example.com","is_idn":false,"min_ttl":181,"records":{"A":[{"ip":"172.66.147.243","ttl":181,"type":"A"},{"ip":"104.20.23.154","ttl":181,"type":"A"}],"MX":[{"pri":0,"ttl":188,"type":"MX","target":""}],"NS":[{"ttl":6574,"type":"NS","target":"elliott.ns.cloudflare.com"},{"ttl":6574,"type":"NS","target":"hera.ns.cloudflare.com"}],"SOA":[{"ttl":1174,"type":"SOA","mname":"elliott.ns.cloudflare.com","retry":2400,"rname":"dns.cloudflare.com","expire":604800,"serial":2418004112,"refresh":10000,"minimum-ttl":1800}],"TXT":[{"ttl":300,"txt":"v=spf1 -all","type":"TXT"},{"ttl":300,"txt":"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9","type":"TXT"}],"AAAA":[{"ttl":181,"ipv6":"2606:4700:10::6814:179a","type":"AAAA"},{"ttl":181,"ipv6":"2606:4700:10::ac42:93f3","type":"AAAA"}]},"elapsed_ms":1656,"queried_at":"2026-10-23T11:59:37Z","ascii_domain":"example.com","record_count":10}}

反向解析

查询 IP 地址对应的 PTR 记录。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/dns/reverse JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ip	string	是	待查询 IP 地址（支持 IPv4 / IPv6）
force	boolean	否	为 true 时跳过缓存，强制实时查询

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ip	string	IP 地址
data.version	string	IP 版本：IPv4 / IPv6
data.ptr	array	反向解析（PTR）记录
data.ptr[]	string	单个 PTR 主机名
data.has_ptr	boolean	是否存在 PTR 记录
data.cached	boolean	是否命中缓存
data.queried_at	string	数据查询时间（UTC，ISO 8601）
data.elapsed_ms	integer	服务端处理耗时（毫秒）
data.note	string	未查询到 PTR 记录时的提示，仅 has_ptr 为 false 时返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"ip":"8.8.8.8","ptr":["dns.google"],"cached":true,"has_ptr":true,"version":"IPv4","elapsed_ms":0,"queried_at":"2026-10-23T11:59:42Z"}}

批量解析

一次查询多个域名，单次最多 10 条。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/dns/batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
domains	array	是	待查询域名数组，最多 10 条；超过 10 条 → 4006；任一元素非字符串 / 空串 / 超长 → 400，非法域名 → 400（整批失败，不做部分返回）
types	string	否	记录类型，逗号分隔字符串或数组；含无法识别的类型 → 400；默认返回全部 15 种类型
type	string	否	types 的别名，两者等价；同时传入时以 types 为准
server	string	否	指定 DNS 服务器 IP，默认使用系统 DNS；非法值 → 400；服务器不可达时可能返回空记录
force	boolean	否	为 true 时跳过缓存，强制实时查询

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].msg	string	提示信息，成功为 success，查询失败为 invalid_argument
data.list[].code	integer	该条查询结果码，0 表示成功，5001 表示查询失败
data.list[].data	object	该条查询结果，结构同 DNS 解析接口的 data；查询失败时无此字段
data.list[].data.types	array	类型列表
data.list[].data.cached	boolean	是否命中缓存
data.list[].data.domain	string	域名
data.list[].data.is_idn	boolean	是否为国际化域名
data.list[].data.min_ttl	integer	最小 TTL（秒）
data.list[].data.records	object	DNS 记录集合，按记录类型分组，仅包含本次实际查到的类型（未查到的类型不会出现该键）；无记录时为空数组 []
data.list[].data.records.A	array	A 记录列表
data.list[].data.records.A[]	object	A 记录
data.list[].data.records.A[].ip	string	IP 地址
data.list[].data.records.A[].ttl	integer	缓存有效期（秒）
data.list[].data.records.A[].type	string	类型
data.list[].data.records.MX	array	MX 记录列表
data.list[].data.records.MX[]	object	MX 记录
data.list[].data.records.MX[].pri	integer	优先级
data.list[].data.records.MX[].ttl	integer	缓存有效期（秒）
data.list[].data.records.MX[].type	string	类型
data.list[].data.records.MX[].target	string	目标主机
data.list[].data.records.NS	array	NS 记录列表
data.list[].data.records.NS[]	object	NS 记录
data.list[].data.records.NS[].ttl	integer	缓存有效期（秒）
data.list[].data.records.NS[].type	string	类型
data.list[].data.records.NS[].target	string	目标主机
data.list[].data.records.SOA	array	SOA 记录列表
data.list[].data.records.SOA[]	object	SOA 记录
data.list[].data.records.SOA[].ttl	integer	缓存有效期（秒）
data.list[].data.records.SOA[].type	string	类型
data.list[].data.records.SOA[].mname	string	主域名服务器
data.list[].data.records.SOA[].retry	integer	重试间隔（秒）
data.list[].data.records.SOA[].rname	string	管理员邮箱
data.list[].data.records.SOA[].expire	integer	过期时间（秒）
data.list[].data.records.SOA[].serial	integer	序列号
data.list[].data.records.SOA[].refresh	integer	刷新间隔（秒）
data.list[].data.records.SOA[].minimum-ttl	integer	最小 TTL（秒）
data.list[].data.records.TXT	array	TXT 记录列表
data.list[].data.records.TXT[]	object	TXT 记录
data.list[].data.records.TXT[].ttl	integer	缓存有效期（秒）
data.list[].data.records.TXT[].txt	string	TXT 记录内容
data.list[].data.records.TXT[].type	string	类型
data.list[].data.records.AAAA	array	AAAA 记录列表
data.list[].data.records.AAAA[]	object	AAAA 记录
data.list[].data.records.AAAA[].ttl	integer	缓存有效期（秒）
data.list[].data.records.AAAA[].ipv6	string	IPv6 地址
data.list[].data.records.AAAA[].type	string	类型
data.list[].data.records.CNAME	array	CNAME 记录列表
data.list[].data.records.CNAME[]	object	CNAME 记录
data.list[].data.records.CNAME[].type	string	类型
data.list[].data.records.CNAME[].ttl	integer	缓存有效期（秒）
data.list[].data.records.CNAME[].target	string	指向的目标域名
data.list[].data.records.PTR	array	PTR 记录列表（反向解析）
data.list[].data.records.PTR[]	object	PTR 记录
data.list[].data.records.PTR[].type	string	类型
data.list[].data.records.PTR[].ttl	integer	缓存有效期（秒）
data.list[].data.records.PTR[].target	string	反向解析得到的主机名
data.list[].data.records.SRV	array	SRV 记录列表
data.list[].data.records.SRV[]	object	SRV 记录
data.list[].data.records.SRV[].type	string	类型
data.list[].data.records.SRV[].ttl	integer	缓存有效期（秒）
data.list[].data.records.SRV[].pri	integer	优先级，数值越小优先级越高
data.list[].data.records.SRV[].weight	integer	权重
data.list[].data.records.SRV[].port	integer	服务端口
data.list[].data.records.SRV[].target	string	目标主机名
data.list[].data.records.CAA	array	CAA 记录列表
data.list[].data.records.CAA[]	object	CAA 记录
data.list[].data.records.CAA[].type	string	类型
data.list[].data.records.CAA[].ttl	integer	缓存有效期（秒）
data.list[].data.records.CAA[].flags	integer	标志位
data.list[].data.records.CAA[].tag	string	标签，如 issue / issuewild / iodef
data.list[].data.records.CAA[].value	string	标签对应的值
data.list[].data.records.{TYPE}	array	其他类型记录列表（HINFO / NAPTR / DNSKEY / DS / TLSA），按实际查到的类型分组
data.list[].data.records.{TYPE}[]	object	其他类型记录
data.list[].data.records.{TYPE}[].type	string	类型
data.list[].data.records.{TYPE}[].ttl	integer	缓存有效期（秒）
data.list[].data.records.{TYPE}[].value	string	记录原始内容
data.list[].data.elapsed_ms	integer	耗时（毫秒）
data.list[].data.queried_at	string	数据查询时间（UTC，ISO 8601）
data.list[].data.ascii_domain	string	ASCII 域名
data.list[].data.record_count	integer	记录数量
data.list[].query	string	查询内容
data.total	integer	总条数
data.errors	array	错误列表
data.max_limit	integer	允许返回的最大条数
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4006 错误，不会截断）
data.error_count	integer	错误数量
data.errors[]	object	查询失败的条目
data.errors[].query	string	查询失败的域名
data.errors[].error	string	失败原因标识
data.list[].data.types[]	string	记录类型

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"msg":"success","code":0,"data":{"types":["A","MX"],"cached":false,"domain":"example.com","is_idn":false,"min_ttl":169,"records":{"A":[{"ip":"104.20.23.154","ttl":169,"type":"A"},{"ip":"172.66.147.243","ttl":169,"type":"A"}],"MX":[{"pri":0,"ttl":175,"type":"MX","target":""}]},"elapsed_ms":3,"queried_at":"2026-10-23T11:59:47Z","ascii_domain":"example.com","record_count":3},"query":"example.com"},{"msg":"success","code":0,"data":{"types":["A","MX"],"cached":false,"domain":"cloudflare.com","is_idn":false,"min_ttl":300,"records":{"A":[{"ip":"104.16.132.229","ttl":300,"type":"A"},{"ip":"104.16.133.229","ttl":300,"type":"A"}],"MX":[{"pri":5,"ttl":1800,"type":"MX","target":"mxa-canary.global.inbound.cf-emailsecurity.net"},{"pri":5,"ttl":1800,"type":"MX","target":"mxb-canary.global.inbound.cf-emailsecurity.net"},{"pri":10,"ttl":1800,"type":"MX","target":"mxa.global.inbound.cf-emailsecurity.net"},{"pri":10,"ttl":1800,"type":"MX","target":"mxb.global.inbound.cf-emailsecurity.net"}]},"elapsed_ms":18,"queried_at":"2026-10-23T11:59:47Z","ascii_domain":"cloudflare.com","record_count":6},"query":"cloudflare.com"}],"total":2,"errors":[],"max_limit":10,"truncated":false,"error_count":0}}

产品说明

产品概述

DNS 域名解析服务提供标准 DNS 查询能力，覆盖 A、AAAA、CNAME、MX、NS、TXT、SOA、PTR、SRV、HINFO、NAPTR、CAA、DNSKEY、DS、TLSA 共 15 种记录类型，可直接获取域名的实时解析结果。

除单域名解析（resolve）外，同时提供 IP 反向解析（reverse，查询 PTR 记录）与批量解析（batch，单次最多 50 个域名），满足从单点核验到批量盘点的不同需求。

主要能力

按类型过滤：通过 types 指定所需记录类型，减少无效数据传输；不指定时返回全部 15 种类型。
国际化域名：支持 IDN 域名，响应中同时给出原始域名与 Punycode 形式的 ASCII 域名。
指定 DNS 服务器：可指定递归服务器 IP 发起查询，便于对比不同线路的解析结果。
缓存与强刷：结果经进程内 LRU 与 Redis 二级缓存，命中时 cached 为 true；传 force=true 可跳过缓存强制实时查询。

返回约定

成功时 code 为 200、msg 为 success；健康检查接口 ping 的 msg 为 pong。
时间字段 queried_at 为 UTC 时间的 ISO 8601 格式，请按需转换为本地时区。
指定 server 后若该服务器不可达，可能返回空记录（record_count 为 0），属正常结果而非错误。

核心功能

15 种记录类型

覆盖 A、AAAA、CNAME、MX、NS、TXT、SOA、PTR、SRV、HINFO、NAPTR、CAA、DNSKEY、DS、TLSA

国际化域名

支持 IDN 域名解析，返回原始域名与 Punycode 形式的 ASCII 域名

批量解析

单次最多查询 50 个域名，逐条返回结果与失败原因

反向解析

由 IP 反查 PTR 记录，支持 IPv4 与 IPv6

指定 DNS 服务器

可指定递归服务器 IP，便于对比不同线路的解析结果

二级缓存

进程内 LRU 与 Redis 缓存，支持 force 参数强制实时查询

使用场景

网站与邮件配置核查：批量校验 A、MX、TXT（SPF）等记录是否已正确生效

域名资产盘点：批量拉取多个域名的解析记录，梳理归属与 NS 分布

CDN 与调度诊断：对比不同 DNS 服务器返回结果，定位解析不一致问题

日志与安全分析：通过 PTR 反向解析还原访问来源主机名

上线前检查：发布前确认新域名解析已生效，避免切换故障

费用计算

按次计费单价

¥0.001 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.1	¥0.0010/次	-	365 天
500次调用包	500 次	¥0.475	¥0.00095/次	省5%	365 天
1000次调用包	1000 次	¥0.9	¥0.0009/次	省10%	365 天
5000次调用包	5000 次	¥4.25	¥0.00085/次	省15%	365 天
10000次调用包	10000 次	¥8	¥0.0008/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.001/次
个人版	5000 次	5000 次	10%	¥0.0009/次
专业版	30000 次	30000 次	20%	¥0.0008/次
企业版推荐	200000 次	200000 次	30%	¥0.0007/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.001 × 1000 = ¥1.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.001 × (1 - 10%) × 1000 ≈ ¥0.90

示例3：购买「500次调用包」次数包

支付 ¥0.475，获得 500 次调用，折算单价 ¥0.00095/次

同等次数按次付费需 ¥0.50，次数包可节省 ¥0.025

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值；具体原因见响应 msg
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

v1.0.0 2026-08-02

首次上线 DNS 域名解析接口，提供 resolve / reverse / batch 三个分支接口
支持 15 种 DNS 记录类型与国际化域名
支持指定 DNS 服务器与强制跳过缓存
批量解析单次上限 50 条