TIAN.HU API 文档

涵盖域名Whois查询、价格查询、翻译服务、域名统计

v2.0.0

📡 API 基础信息

Base URL: https://api.tian.hu
Request Header:
lang zh | en (返回提示语国际化)
限流策略:

• 限流规则: 每分钟 25 次 / 每日 300 次

• 触发限流时返回 429 状态码

• 响应头包含限流信息:

X-RateLimit-Remaining-PerMinute: 3 - 每分钟剩余次数(令牌持续恢复)
X-RateLimit-Remaining-PerDay: 295 - 每日剩余次数
X-RateLimit-Status: allowed - 限流状态(allowed/limited/error)

WHOIS 查询

GET /whois/{domain}
查询域名 WHOIS 信息,返回包含域名状态、注册信息、格式化数据、标签等完整信息
$ curl https://api.tian.hu/whois/baidu.com
请求参数:
  • domain [必填] (path) - 域名(支持中文域名)
返回值说明:
  • domain - 格式化后的最短有效域名
  • status - 域名状态:-1(未知) 0(未注册) 1(已注册) 2(保留) 3(DROPZONE) 4(受保护)
  • result - 原始 WHOIS 数据文本
  • formatted - 格式化后的 WHOIS 数据对象(包含注册商、DNS、时间等)
  • tld - 顶级域名后缀
  • rdap - 是否通过 RDAP 协议查询(true/false)
  • tags - 域名相关标签数组
  • statusTags - 域名状态标签数组
  • timezone - 域名所属时区信息
测试结果:

                

域名批量检查

POST /domains/dns/batch
批量 DNS 检查域名可用性,通过DNS记录快速粗略判断域名是否已注册。不保证准确性,如果使用Whois查询同一个后缀特别多的话,Whois服务器会拒绝响应。
$ curl -X POST https://api.tian.hu/domains/dns/batch \ -H "Content-Type: application/json" \ -d '[{"domain":"example1.com"},{"domain":"example2.com"}]'
请求参数:
  • body [必填] (body) - JSON数组,每个元素包含 domain 字段
请求体示例:
[
    {
        "domain": "example1.com"
    },
    {
        "domain": "example2.com"
    }
]
返回值说明:
  • [数组] - 返回包含所有域名的数组,每个元素包含:
  • domain - 域名
  • status - 域名状态:-1(未知) 0(未注册) 1(已注册) 2(保留)
  • message - 错误消息(可选,验证失败时返回)
  • error - 异常信息(可选,查询异常时返回)
测试结果:

                

DNS 查询

GET /dns/{domain}
查询域名的所有 DNS 记录类型(A、NS、MX、SOA、TXT、AAAA、CNAME)
$ curl https://api.tian.hu/dns/baidu.com
请求参数:
  • domain [必填] (path) - 域名
返回值说明:
  • [数组] - DNS记录数组,每个元素包含:
  • type - 记录类型(A/NS/MX/SOA/TXT/AAAA/CNAME)
  • ttl - TTL值
  • entries - 记录内容(格式化字符串)
测试结果:

                

RDAP 查询

GET /rdap/{domain}
通过 RDAP 协议查询域名信息,返回 RDAP 服务器的原始 JSON 响应数据
$ curl https://api.tian.hu/rdap/google.com
请求参数:
  • domain [必填] (path) - 域名
返回值说明:
  • [原始RDAP JSON] - RDAP服务器返回的完整 JSON 数据,包含 ldhName、status、events、entities、nameservers 等字段
测试结果:

                
GET /rdap/list
获取所有支持的 RDAP 服务器列表,返回TLD到服务器URL的映射
$ curl https://api.tian.hu/rdap/list
测试结果:

                

价格查询

GET /pricing/{domain}
查询域名注册价格,自动从多个注册商获取最优价格
$ curl https://api.tian.hu/pricing/example.com
请求参数:
  • domain [必填] (path) - 域名
返回值说明:
  • premium - 是否为溢价域名(true/false)
  • register - 注册价格(人民币)
  • renew - 续费价格(人民币)
  • register_usd - 注册价格(美元)
  • renew_usd - 续费价格(美元)
  • cached - 数据是否来自缓存
测试结果:

                
GET /tlds/pricing/{tld}
查询指定 TLD 的价格列表,返回多个注册商的价格数组
$ curl https://api.tian.hu/tlds/pricing/com
请求参数:
  • tld [必填] (path) - 顶级域名后缀(如 com、net)
返回值说明:
  • [数组] - 注册商价格列表数组,每个元素包含:
  • provider - 注册商名称
  • new - 注册价格(人民币)
  • renew - 续费价格(人民币)
  • transfer - 转移价格(人民币)
  • new_usd - 注册价格(美元)
  • renew_usd - 续费价格(美元)
  • transfer_usd - 转移价格(美元)
  • currency - 原始货币单位
测试结果:

                

翻译服务

GET /translate/{domain}
翻译域名或文本,支持中英互译
$ curl https://api.tian.hu/translate/百度
请求参数:
  • domain [必填] (path) - 要翻译的域名或文本
返回值说明:
  • pid - 翻译提供商标识(B:百度, L:DeepL)
  • src - 源文本
  • dst - 翻译结果
  • dict - 词典信息(可选)
测试结果:

                

域名统计

GET /stats/domain/{domain}
查询包含特定关键词的域名注册量统计
$ curl https://api.tian.hu/stats/domain/baidu
请求参数:
  • domain [必填] (path) - 域名关键词或完整域名
返回值说明:
  • keyword - 查询关键词
  • list - 域名统计列表数组
  • source - 数据来源(remote/local)
  • updated_at - 数据更新时间
  • domain - 完整域名的注册状态(可选,仅当查询完整域名时返回)
测试结果:

                

实用工具

GET /ip
获取客户端真实 IP 地址,直接返回IP字符串
$ curl https://api.tian.hu/ip
测试结果:

                
GET /utils/huilv
获取实时汇率信息,支持查询所有货币或指定货币的汇率(基于欧元)
$ curl https://api.tian.hu/utils/huilv?currency=CNY,USD
请求参数:
  • currency [可选] (query) - 货币代码,多个用逗号分隔(如:CNY,USD,JPY),不传则返回所有货币
返回值说明:
  • base_currency - 基准货币(EUR)
  • last_update - 上次更新时间(UTC)
  • next_update - 下次更新时间(UTC)
  • count - 返回的货币数量
  • rates - 汇率对象,键为货币代码,值为汇率
测试结果:

                
GET /utils/status
获取系统运行状态信息,包括服务器时间、PHP版本、内存使用等
$ curl https://api.tian.hu/utils/status
测试结果:

                
GET /utils/ping
Ping测试接口,用于检测API服务是否正常
$ curl https://api.tian.hu/utils/ping
测试结果:

                

响应格式

所有 API 响应均采用统一的 JSON 格式:

{ "code": 200, "msg": "查询成功", "data": { ... } }

状态码说明: