IP天气访客信息接口介绍

调用说明 调用示例 在线测试
接口地址: https://ping.4759.cn/api/ua.php
请求方式: GET/POST
返回格式: JSON
频率限制: 按APIKey等级限制
使用方式: 必须传入 KEY 授权码
缓存机制: 同一IP请求缓存5分钟
支持功能: 自动获取访客IP、访客UA、省份城市、7天天气预报、调用统计

本接口自动获取访客IP、设备UA信息、IP归属地省份+城市,并返回7天精准天气预报,需携带API Key授权使用,支持授权等级、每日调用次数限制、接口访问统计。

调用说明

1. 调用方式

必须携带 key 参数,接口会自动获取访问者IP并返回IP+UA+归属地+天气信息。

2. 请求参数

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

3. 接口限制

限制项规则
请求频率同一IP 1分钟最多 100 次
授权模式需 API Key 授权
数据缓存无,实时返回

4. 返回字段说明

参数名类型说明
codeint200 成功,401 授权错误,429 频率超限
msgstring提示信息
data.user_ipstring访客真实IP
data.user_uastring访客设备/浏览器UA信息
data.provincestring省份
data.citystring城市
data.adcodestring城市行政区划代码
data.weatherarray7天天气预报
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", "data": { "user_ip": "203.168.22.35", "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", "province": "广东省", "city": "广州市", "adcode": "440100", "weather": [ { "date": "2026-04-29", "week": "星期三", "day": { "weather": "小雨", "temperature": 28, "wind_direction": "东北风", "wind_power": "微风", "humidity": 94 }, "night": { "weather": "多云", "temperature": 17, "wind_direction": "无持续风向", "wind_power": "微风", "humidity": 72 } } ] }, "call_stats": { "used_day": 4, "remaining_day": 496 } }

在线测试

点击按钮即可实时获取你的IP+UA+天气信息...
服务器检测中...