代码改变世界

反向DNS查询与蜘蛛验证免费API接口详细教程 - 教程

2026-01-12 11:39  tlnshuju  阅读(24)  评论(0)    收藏  举报

在网站运维、SEO分析或安全监控中,我们经常需要判断访问者的IP地址是否为合法的搜索引擎蜘蛛(如百度、Google等),而非恶意爬虫。一个可靠的方法就是进行反向DNS查询。本文将详细介绍由“接口盒子”免费API提供的免费、高效的反向DNS查询与蜘蛛验证API接口。

一、接口简介

该接口的主要功能是查询指定IP地址的反向DNS记录,并基于此记录智能判断该IP是否属于已知的搜索引擎蜘蛛。其工作原理如下:

  1. 1.

    反向DNS查询:首先,接口会查询给定IP的PTR记录,获取其对应的域名(例如,IP 220.181.108.75可能对应 baiduspider-220-181-108-75.crawl.baidu.com)。

  2. 2.

    蜘蛛模式匹配:接着,接口会将获取到的域名与内置的数十种国内外蜘蛛(如Baidu、Googlebot、Bingbot等)的域名模式进行匹配。

  3. 3.

    双向DNS验证:为提高准确性,接口还会进行正向验证,即将匹配到的域名再次进行正向DNS解析(A记录查询),检查解析出的IP列表中是否包含最初查询的IP。这一步能有效防止伪造的PTR记录。

重要提示:并非所有蜘蛛IP都设置了反向DNS记录,且蜘蛛的域名也可能发生变化。因此,该接口的识别结果仅供参考,但结合了双向验证后,其可靠性非常高。

二、接口基本信息
  • 请求地址https://cn.apihz.cn/api/ip/fdns.php

  • 请求方式: GET 或 POST

  • 返回格式: JSON

三、请求参数说明

参数名

类型

是否必填

说明

id

整数

用户中心的数字ID。需要注册账号后获取。

key

字符串

用户中心的通讯秘钥,用于认证。

ip

字符串

要查询的IP地址(IPv4)。如不提供,则默认查询调用接口的客户端IP。示例:ip=220.181.108.75

四、返回参数详解

返回的JSON数据包含丰富的状态和信息字段:

参数名

类型

说明

code

整数

状态码200代表成功,400代表错误。

msg

字符串

与状态码对应的详细消息,如“查询成功”。

ip

字符串

你查询的IP地址。

reverse_dns

字符串

查询到的反向DNS记录。如果不存在则为空。

reverse_dns_exists

布尔值

是否存在反向DNS记录。

is_bot

布尔值

核心结果。是否被识别为蜘蛛。

verified

布尔值

核心结果。双向验证是否通过。true表示结果可信度极高。

query_time

浮点数

查询耗时,单位是毫秒(ms)。

timestamp

字符串

数据缓存的时间戳。接口有1天缓存期。

reverse_verification

对象

反向验证的详细数据集。

reverse_verification.match

布尔值

反向DNS是否匹配到蜘蛛模式。

reverse_verification.detected_bot

布尔值

是否检测到蜘蛛。

reverse_verification.matched_pattern

字符串

匹配到的蜘蛛域名模式(如.baidu.com)。

reverse_verification.bot_id

字符串

蜘蛛标识符(如baidu)。

reverse_verification.bot_name

字符串

蜘蛛名称(如Baidu)。

forward_verification

对象

正向验证的详细数据集。

forward_verification.performed

布尔值

是否执行了正向验证。

forward_verification.match

布尔值

正向验证是否匹配。

forward_verification.forward_ips

数组

将匹配到的域名进行正向解析得到的IP列表。

forward_verification.original_ip_in_forward_ips

布尔值

查询的原始IP是否在forward_ips列表中。

五、调用示例

重要:示例中的 idkey为公共测试凭证,调用频次受限。请务必在接口盒子官网注册账号,获取您独享的 idkey,以保证服务的稳定性。

1. 浏览器直接访问(GET请求)

最简单的方法是将参数直接拼接在URL后,在浏览器中访问即可看到结果。

复制

https://cn.apihz.cn/api/ip/fdns.php?id=88888888&key=88888888&ip=220.181.108.75
2. PHP调用示例

以下示例演示了如何使用PHP的cURL库进行GET请求,并解析返回的JSON数据。

php

复制

3. Python调用示例

以下示例使用Python内置的 urllib库进行GET请求。

python

下载

复制

运行

import urllib.request
import urllib.parse
import json
# 你的API凭证(请替换成你自己的)
api_id = "你的用户ID"
api_key = "你的用户KEY"
ip_to_query = "220.181.108.75"
# 构建请求参数
params = {
    "id": api_id,
    "key": api_key,
    "ip": ip_to_query
}
# 将参数编码并拼接成URL
query_string = urllib.parse.urlencode(params)
url = f"https://cn.apihz.cn/api/ip/fdns.php?{query_string}"
try:
    # 发起请求
    with urllib.request.urlopen(url) as response:
        # 读取并解码响应内容
        response_data = response.read().decode('utf-8')
        # 解析JSON数据
        data = json.loads(response_data)
    # 处理结果
    if data.get('code') == 200:
        print(f"查询IP: {data['ip']}")
        print(f"反向DNS: {data['reverse_dns']}")
        print(f"是否为蜘蛛: {'是' if data['is_bot'] else '否'}")
        print(f"双向验证通过: {'是' if data['verified'] else '否'}")
        if data['is_bot']:
            print(f"蜘蛛名称: {data['reverse_verification']['bot_name']}")
    else:
        print(f"查询失败!错误信息: {data.get('msg', 'Unknown error')}")
except Exception as e:
    print(f"请求过程中发生错误: {e}")
六、成功返回示例解析

当我们使用上述示例查询百度蜘蛛IP时,会得到如下结构的JSON结果:

json

复制

{
  "code": 200,
  "msg": "查询成功",
  "ip": "220.181.108.75",
  "reverse_dns": "baiduspider-220-181-108-75.crawl.baidu.com",
  "reverse_dns_exists": true,
  "reverse_verification": {
    "match": true,
    "detected_bot": true,
    "matched_pattern": ".baidu.com",
    "bot_id": "baidu",
    "bot_name": "Baidu"
  },
  "forward_verification": {
    "performed": true,
    "match": true,
    "forward_ips": ["220.181.108.75"],
    "original_ip_in_forward_ips": true
  },
  "is_bot": true,
  "verified": true,
  "query_time": 4749.81,
  "timestamp": "2025-12-08 13:29:52"
}

结果解读

  1. 1.

    查询的IP 220.181.108.75存在反向DNS记录,记录值为 baiduspider-...crawl.baidu.com

  2. 2.

    该域名匹配到了蜘蛛模式 .baidu.com,被识别为百度蜘蛛(Baidu)。

  3. 3.

    接口执行了正向验证,将 baiduspider-...crawl.baidu.com解析回IP地址,得到的IP列表(["220.181.108.75"])中包含了原始查询IP。

  4. 4.

    因此,最终结论 is_botverified均为 true,可以确信该IP是真正的百度蜘蛛。

总结

接口盒子提供的反向DNS查询API是一个功能强大且易于使用的工具,特别适合用于:

  • 网站日志分析:自动化识别搜索引擎蜘蛛的访问记录。

  • 流量过滤:在应用程序中区分真实用户和搜索引擎爬虫。

  • 安全防护:辅助判断可疑爬虫身份。

由于其免费、返回信息详尽且带有双向验证机制,对于开发者和运维人员来说,是一个非常实用的选择。只需简单注册,即可开始集成使用。