IP 查询接口文档

传入 IP 地址，返回该 IP 的蜘蛛类型与访问时间记录。极简高效，开箱即用。

核心功能说明

接口规范

• 请求方式：支持 GET 和 POST（通过 $_REQUEST 兼容），适配不同调用场景
• 返回格式：标准 JSON，包含 code（状态码）、msg（提示信息）、data（结果数据）
• 字符编码：UTF-8，避免中文乱码
• 跨域支持：默认允许所有域名访问（如需限制，可修改 Access-Control-Allow-Origin 为指定域名）

参数校验

• 必传参数检查：校验 ip 参数是否存在且非空
• IP 格式校验：使用 filter_var 验证 IP 地址合法性，避免无效查询

安全防护

• SQL 注入防护：通过 mysqli_real_escape_string 转义 IP 参数
• 错误信息处理：数据库错误信息仅返回给调用方，不暴露敏感配置

数据返回逻辑

• 仅返回 spider（蜘蛛类型）和 time（访问时间），符合核心需求
• 结果按 id 倒序排列，最新数据在前
• 无数据时返回友好提示（状态码仍为 200，仅 msg 提示无数据）

接口调用示例

1. GET 请求

http://jiaotu.wanyouhui.com/api.php?ip=85.208.96.204

2. POST 请求（Form 表单）

POST /api.php
Content-Type: application/x-www-form-urlencoded

ip=85.208.96.204

3. 返回结果示例

有数据时：

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "spider": "百度蜘蛛",
            "time": "2026-01-26 10:30:00"
        },
        {
            "spider": "百度蜘蛛",
            "time": "2026-01-26 09:15:00"
        }
    ]
}

无数据时：

{
    "code": 200,
    "msg": "未查询到该IP的蜘蛛信息",
    "data": []
}

参数错误时：

{
    "code": 400,
    "msg": "IP地址格式不正确",
    "data": []
}