综合查询接口开发文档

接口概述

该接口采用 HTTP GET 方式请求，返回 JSON 格式数据。主要用于获取与关键词匹配的文本信息，适用于自动化查询、数据聚合等场景。

请求地址

http://support.funyun.xyz/ bf32a08125bed4b18a945233eafe70d9/ fgSsjmdNq18GX1XTmzSJ8ns44848GnIq/ vip.php（具体地址以实际部署为准）

请求参数

接口需要两个必填参数，请务必正确传递：

参数名	类型	必填	说明
key	string	是	授权密钥，用于验证调用身份。请使用平台下发的固定密钥（例如 qxnb）。
tx	string	是	查询关键词，支持姓名、手机号、身*证、地址、QQ、微信、车牌号等，需进行 URL 编码。

示例请求：

GET /vip.php?key=qxnb&tx=%E5%BC%A0%E4%B8%89

（%E5%BC%A0%E4%B8%89 为“张三”的 URL 编码）

响应格式

接口统一返回 JSON 格式，包含以下字段：

• code：状态码，200 表示成功，其他为错误。
• msg：描述信息。
• data：成功时返回查询结果文本（多行），若未命中则为 null。

成功示例：

{
    "code": 200,
    "data": "调用成功，命中3条\n张三 13800138000 广东省深圳市\n张三 13900139000 北京市海淀区\n张三 13700137000 上海市浦东新区"
}

未命中示例：

{
    "code": 200,
    "data": null,
    "msg": "未查询到数据"
}

错误码说明

code	含义	处理建议
403	密钥无效	检查 key 参数是否正确。
400	缺少查询参数	确保 tx 参数已传递且非空。
429	调用量过载	请求频率过高，请稍后重试（详见下方限流策略）。
500	第三方接口请求失败	后端服务暂时不可用，可稍后重试。

限流策略

为了保护服务稳定性，接口实施了严格的限流措施：

• 每个 IP 或密钥每分钟最多允许 30 次 调用。
• 超过该限额后，系统将返回 429 错误，并封禁 120 秒（2 分钟），期间所有请求均被拒绝。
• 封禁结束后自动恢复，但会重新计数。

此外，当数据源触发 WAF 或 CC 防御时，接口同样会返回 429，提示“请求量过载，请稍后”，此时建议降低调用频率或错峰请求。

数据过滤说明

返回结果中已自动过滤掉广告、引流信息、客服联系方式等无关内容，保证数据纯净。若过滤后结果为空，则返回未命中提示。

注意事项

• 密钥安全：请勿将密钥硬编码在客户端，建议在服务端调用。
• 编码问题：查询关键词（tx）必须进行 URL 编码，避免特殊字符导致解析错误。
• 并发限制：高并发场景下请合理排队请求，避免触发限流。
• 灰度测试：本接口仍在持续优化中，数据准确性及可用性可能受上游影响，请以实际返回为准。