自动定位天气接口介绍

调用说明 调用示例 在线测试
接口地址: http(s)://ping.4759.cn/api/weather_api.php
请求方式: GET
返回格式: JSON
频率限制: 按APIKey等级限制
授权要求: 需携带有效的key参数
定位方式: 自动获取访问者IPv4 → 自动定位城市天气
数据来源: 腾讯天气(未来6天预报)
报错提示: 接口报错时末尾会自动显示官方域名

本API无需传入城市、无需adcode,自动获取访问者IP,自动定位当地天气,支持未来6天预报,数据稳定、响应快、无缓存、纯实时接口。
注意:必须携带有效API Key,未授权无法调用。

调用说明

1. 请求参数

参数名 必选 类型 说明 示例值
key string API授权码 user_xxxx

2. 返回参数

参数名 类型 说明
code int 200成功,400/401/403/404/429/500错误
msg string 返回信息
data object 天气数据
data.user_ip string 访问者IP
data.province string 省份
data.city string 城市
data.adcode string 城市编码
data.weather array 未来6天天气预报
call_stats object 当日调用统计

3. 状态码说明

调用示例

1. GET请求(最简调用)

http://ping.4759.cn/api/weather_api.php?key=你的授权码

2. PHP调用示例

<?php // +---------------------------------------------------------------------- // | 自动定位天气 PHP调用示例 // | 复制即可使用,需替换为自己的API Key // +---------------------------------------------------------------------- $key = "你的授权码"; $url = "http://ping.4759.cn/api/weather_api.php?key=" . urlencode($key); $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $url, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_SSL_VERIFYPEER => false ]); $response = curl_exec($ch); curl_close($ch); $result = json_decode($response, true); print_r($result); ?>

3. Python调用示例

import requests key = "你的授权码" url = f"http://ping.4759.cn/api/weather_api.php?key={key}" res = requests.get(url, timeout=10) print(res.json())

4. 成功返回示例

{ "code": 200, "msg": "success", "data": { "user_ip": "123.123.123.123", "province": "广东省", "city": "汕尾市", "adcode": "441500", "weather": [ { "date": "2026-03-30", "day": {...} } ] }, "call_stats": { "used_day": 5, "remaining_day": 995 } }

在线测试

点击按钮直接获取你当前所在地的天气...
服务器检测中...