文档中心

接口地址：https://api.xiaotuo.net/api.php?act=Api_send&id=143

返回格式：json

请求方式：GET

请求示例：https://api.xiaotuo.net/api.php?act=Api_send&id=143&apikey=你开通的apikey&city_id=城市ID&city=城市名称，如：南昌&province=省份，如：江西；和city配合使用。传入该参数则会查询该省份下面的城市&ip=根据ip查询所在城市的天气，默认为当前请求接口的IP&lon=经度，通过经纬度查询&lat=纬度，通过经纬度查询

请求参数说明：

名称	必填	类型	说明
apikey	是	string	你开通的apikey
city_id	否	string	城市ID
city	否	string	城市名称，如：南昌
province	否	string	省份，如：江西；和city配合使用。传入该参数则会查询该省份下面的城市
ip	否	string	根据ip查询所在城市的天气，默认为当前请求接口的IP
lon	否	string	经度，通过经纬度查询
lat	否	string	纬度，通过经纬度查询

返回参数说明：

名称	类型	说明
city	string	城市
city_en	string	城市英文
province	string	省份
province_en	string	省份英文
city_id	string	城市ID
date	string	日期
update_time	string	更新时间
weather	string	天气情况
weather_code	string	天气code
temp	string	当前温度
min_temp	string	最低文档
max_temp	string	最高文档
wind	string	风向
wind_speed	string	风速
wind_power	string	风力等级
rain	string	字符串类型
rain_24h	string	24小时降雨量
humidity	string	湿度
visibility	string	可见度
pressure	string	字符串类型
tail_number	string	车辆限行
air	string	字符串类型
air_pm25	string	pm25
sunrise	string	日出时间
sunset	string	日落时间

返回示例：

{"request_id":"732980985951424512","success":true,"message":"success","code":200,"data":{"city":"北京","city_en":"beijing","province":"北京","province_en":"beijing","city_id":"101010100","date":"2025-01-01","update_time":"2025-01-01 15:10:56","weather":"多云","weather_code":"duoyun","temp":5,"min_temp":-4,"max_temp":3,"wind":"20%","wind_speed":"6km\/h","wind_power":"2级","rain":"0","rain_24h":"0","humidity":"20%","visibility":"27km","pressure":"1020","tail_number":"4和9","air":"33","air_pm25":"33","sunrise":"07:35","sunset":"16:59","aqi":{"air":"36","air_level":"优","air_tips":"空气很好，呼吸新鲜空气，拥抱大自然！","pm25":"17","pm10":"36","co":"0.4","no2":"19","so2":"3","o3":"50"},"index":[{"type":"diaoyu_index","level":"适宜","name":"钓鱼指数","content":"不冷不热全天钓，烈日炎炎早晚钓，夏末秋初阴雨钓，寒冬腊月中午钓，享受钓鱼乐趣同时还要注意安全"},{"type":"ganmao_index","level":"极易发","name":"感冒指数","content":"综合天气季节考虑，极易发感冒"},{"type":"guoming_index","level":"不易过敏","name":"过敏指数","content":"一般人群不易过敏，敏感人群可能过敏"},{"type":"xiche_index","level":"适宜","name":"洗车指数","content":"天气不错，非常适合洗车"},{"type":"yundong_index","level":"较适宜","name":"运动指数","content":"气温稍低，室外运动时注意适当保温"},{"type":"ziwanxian_index","level":"最弱","name":"紫外线指数","content":"不需要采取防护措施"}],"alarm":[],"hour":[{"time":"2025-01-01 15:00:00","temp":5,"wea":"晴","wea_code":"qing","wind":"东北风","wind_level":"<3级"},{"time":"2025-01-01 16:00:00","temp":5,"wea":"多云","wea_code":"duoyun","wind":"东北风","wind_level":"<3级"},{"time":"2025-01-01 17:00:00","temp":5,"wea":"多云","wea_code":"duoyun","wind":"东北风","wind_level":"<3级"},{"time":"2025-01-01 18:00:00","temp":3,"wea":"多云","wea_code":"duoyun","wind":"东南风","wind_level":"<3级"},{"time":"2025-01-01 19:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-01 20:00:00","temp":0,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-01 21:00:00","temp":-1,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-01 22:00:00","temp":-1,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-01 23:00:00","temp":-1,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 00:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 01:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"东南风","wind_level":"<3级"},{"time":"2025-01-02 02:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 03:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 04:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 05:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 06:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"东南风","wind_level":"<3级"},{"time":"2025-01-02 07:00:00","temp":-1,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 08:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 09:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 10:00:00","temp":0,"wea":"晴","wea_code":"qing","wind":"东南风","wind_level":"<3级"},{"time":"2025-01-02 11:00:00","temp":1,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 12:00:00","temp":1,"wea":"晴","wea_code":"qing","wind":"东南风","wind_level":"<3级"},{"time":"2025-01-02 13:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 14:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"北风","wind_level":"<3级"},{"time":"2025-01-02 15:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"西北风","wind_level":"<3级"},{"time":"2025-01-02 16:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-02 17:00:00","temp":2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 18:00:00","temp":0,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 19:00:00","temp":0,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 20:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 21:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 22:00:00","temp":-2,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-02 23:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-03 00:00:00","temp":-3,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-03 01:00:00","temp":-4,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-03 02:00:00","temp":-5,"wea":"晴","wea_code":"qing","wind":"西南风","wind_level":"<3级"},{"time":"2025-01-03 03:00:00","temp":-5,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-03 04:00:00","temp":-6,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-03 05:00:00","temp":-6,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-03 06:00:00","temp":-6,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"},{"time":"2025-01-03 07:00:00","temp":-6,"wea":"晴","wea_code":"qing","wind":"西风","wind_level":"<3级"}]},"time":1735716285,"usage":0}

错误码	说明
100	您的apikey值为空！
101	您的apikey值不存在！
102	当前来源地址不在白名单内！
103	当前接口为实名认证后可用，请您先进行实名！
104	当前接口为企业认证后可用，请您先进行企业认证！
105	当前接口未通过审核或已停止运营！
106	您的余额不足，请及时充值！
107	您当前的接口免费期限已过期，请及时续费！
108	您的点数包已用完，请及时充值！
109	您的账号已被封禁，不可使用任何接口！

GET 请求 POST 请求

发起请求

在线调试

温馨提示：请修改请求参数，未修改可能返回报错；

参数名称	参数值（修改后测试）

返回结果