访客UA解析接口介绍

调用说明 调用示例 在线测试
接口地址: https://ping.4759.cn/api/ua.php
请求方式: GET/POST
返回格式: JSON
频率限制: 单IP每分钟60次
使用方式: 必须传入 KEY 授权码
缓存机制: 同一IP请求缓存5分钟
支持功能: 自动获取访客真实IP、完整UA精细化解析、设备细分识别、系统版本提取、浏览器版本识别、环境标记(微信/小程序/钉钉/爬虫)、当日调用统计

本接口自动抓取访客真实IP与UA字符串,深度解析设备、操作系统、浏览器信息;细分设备类型PC/手机/平板/小程序/电视/车载,识别微信/钉钉/QQ/爬虫环境,需携带API Key授权使用,支持授权等级、每日调用次数限制、接口访问统计。

调用说明

1. 调用方式

必须携带 key 参数,接口自动获取访问者IP并返回IP+完整UA解析数据,无第三方地域/天气接口依赖。

2. 请求参数

参数名必填说明
keyAPI 授权密钥

3. 接口限制

限制项规则
请求频率同一IP 1分钟最多 60 次
授权模式需 API Key 授权
数据缓存单IP缓存5分钟,减少解析开销
安全拦截内置爬虫/采集UA拦截,直接返回403禁止访问

4. 返回字段说明

参数名类型说明
codeint200 成功,401 授权错误,429 频率超限,403 爬虫拦截,500 服务异常
msgstring提示信息
used_apistring接口标识文本
data.user_ipstring访客真实IPv4地址
data.user_uastring原始访客UA字符串,超长自动截断清洗
data.ua_info.systemstring系统大类:Windows/Android/iOS/macOS/HarmonyOS/Linux/unknown
data.ua_info.system_detailstring系统详细版本,如Windows 10/11、Android 14、iOS 18.1
data.ua_info.devicestring设备大类:pc/mobile/tablet/tv/car/miniprogram
data.ua_info.device_typestring细分设备标识:pc/phone/tablet/miniprogram/tv/car
data.ua_info.browserstring浏览器名称:Chrome/Edge/Firefox/Safari/WeChat/DingTalk/QQ/UC浏览器等
data.ua_info.browser_detailstring浏览器完整版本号
data.ua_info.is_wechatbooltrue=微信内置环境
data.ua_info.is_miniprogrambooltrue=微信小程序环境
data.ua_info.is_dingtalkbooltrue=钉钉内置环境
data.ua_info.is_qqbooltrue=QQ内置环境
data.ua_info.is_botbooltrue=识别为爬虫/无头采集程序
call_stats.used_dayint当日已调用次数
call_stats.remaining_dayint当日剩余可用次数

5. 状态码说明

调用示例

1. 官方调用地址

https://ping.4759.cn/api/ua.php?key=你的APIKEY

2. PHP 调用示例

<?php $apiKey = "你的APIKEY"; $api = "https://ping.4759.cn/api/ua.php?key=".$apiKey; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $api, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 8, CURLOPT_SSL_VERIFYPEER => false, ]); $res = curl_exec($ch); curl_close($ch); echo $res; ?>

成功返回完整示例(最新接口真实格式)

{ "code": 200, "msg": "success", "used_api": "4759.cn UA解析专用接口", "data": { "user_ip": "112.96.208.132", "user_ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36", "ua_info": { "system": "Windows", "system_detail": "Windows 10/11", "device": "pc", "device_type": "pc", "browser": "Google Chrome", "browser_detail": "Chrome 132.0.0.0", "is_wechat": false, "is_miniprogram": false, "is_dingtalk": false, "is_qq": false, "is_bot": false } }, "call_stats": { "used_day": 42, "remaining_day": 458 } }

在线测试

点击按钮即可实时获取你的完整UA解析信息...