本接口提供多运营商DNS解析服务，支持A/AAAA/CNAME/MX/NS/TXT等记录类型查询
接口地址：http://ping.4759.cn/api/dns.php
请求方式：POST/GET（推荐POST）
Content-Type：application/json（POST请求）
授权方式：API Key（需联系管理员申请）
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| api_key | 是 | string | 接口授权码（向管理员申请） | key_123456 |
| domain | 是 | string | 要解析的域名（支持二级/多级域名） | www.baidu.com、qq.com |
| recordType | 否 | string | 解析记录类型，可选值：A/AAAA/CNAME/MX/NS/TXT | A（默认值） |
| queryCount | 否 | int | 每个DNS服务器的查询次数（最多3次） | 1（默认值） |
| mainOperators | 否 | array | 要查询的运营商大类，为空则查询全部 | ["电信DNS", "联通DNS"] |
{
"api_key": "key_123456",
"domain": "www.baidu.com",
"recordType": "A",
"queryCount": 2,
"mainOperators": ["电信DNS", "联通DNS"]
}
Array
(
[code] => 429
[message] => 授权码不存在，如需帮助请访问：4759.cn
[data] => Array
(
)
)
import requests
import json
# 接口地址
url = 'http://ping.4759.cn/api/dns.php'
# 请求参数
data = {
"api_key": "key_123456",
"domain": "www.baidu.com",
"recordType": "A",
"queryCount": 2,
"mainOperators": ["电信DNS", "联通DNS"]
}
# 发送请求
headers = {'Content-Type': 'application/json'}
response = requests.post(url, data=json.dumps(data), headers=headers)
# 解析结果
result = response.json()
print(result)
{
"code": 200,
"message": "DNS解析查询成功",
"data": [
{
"operator": "电信DNS-北京",
"dnsServer": "202.96.128.86",
"location": "中国电信-北京",
"resolveResult": "110.242.68.3",
"ttl": 5,
"avgResponseTime": 15,
"minResponseTime": 12,
"maxResponseTime": 18,
"queryCount": 2,
"successCount": 2,
"successRate": "100%"
},
{
"operator": "联通DNS-上海",
"dnsServer": "221.5.88.88",
"location": "中国联通-上海",
"resolveResult": "110.242.68.4",
"ttl": 5,
"avgResponseTime": 20,
"minResponseTime": 18,
"maxResponseTime": 22,
"queryCount": 2,
"successCount": 2,
"successRate": "100%"
}
],
"call_info": {
"used_day": 5,
"remaining_day": 45,
"used_hour": "无统计",
"remaining_hour": "无统计"
}
}
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 返回状态码（200为成功） |
| message | string | 返回提示信息 |
| data | array | 解析结果数组，每个元素对应一个DNS服务器的解析信息 |
| call_info | object | 调用次数统计（今日已用/剩余次数） |
| 字段名 | 说明 |
|---|---|
| operator | DNS服务器名称（如：电信DNS-北京） |
| dnsServer | DNS服务器IP地址 |
| location | DNS服务器地理位置 |
| resolveResult | 解析结果（IP/域名/TXT内容等） |
| ttl | 解析记录的TTL值（秒） |
| avgResponseTime | 平均响应时间（毫秒） |
| minResponseTime | 最小响应时间（毫秒） |
| maxResponseTime | 最大响应时间（毫秒） |
| successRate | 解析成功率（百分比） |
| 状态码 | 说明 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400 | 参数错误（域名格式无效） | 检查域名格式，确保为合法域名（如：www.baidu.com） |
| 401 | 缺少api_key参数 | 请求中添加有效的api_key参数 |
| 403 | 授权码无效/禁用/过期/次数超限 | 联系管理员核实授权码状态，或等待次日次数重置 |
| 429 | 调用频率超限（IP被拉黑） | 10分钟后重试，或联系管理员加入白名单 |
| 500 | 服务器内部错误 | 联系管理员排查问题 |