依托先进的数据抓取与处理技术,该天气搜索接口可精准获取全国城市及区县的天气数据。不仅能实时返回气温、湿度、气压、风速风向、空气质量指数(AQI)、紫外线强度等15 + 维度天气指数,还提供当日天气全景预览,包含 6 时实时天气状况、白天与夜间天气变化、最高最低温走势、气象预警提示(如暴雨、大风预警及防御指南)等内容。同时,支持一键生成MP3 格式语音预报,开发者通过简单集成即可实现 APP 语音报天气、智能设备语音交互功能,满足天气查询工具、生活服务平台等多场景开发需求,以丰富且精准的天气信息,为用户带来优质的使用体验。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| type | string | 是 | 天气类型:weather、today,分别对应超详细天气数据、当天信息预览,语音预报。 | today |
| msg | string | 是 | 需要查询的城市名称,如:威宁 | 威宁 |
| n | integer | 否 | 当此值为空时返回关键词城市列表,不为空时则返回对应列表内需要的城市当天天气。 | 1 |
[
{
"name": "type",
"type": "string",
"required": true,
"description": "天气类型:weather、today,分别对应超详细天气数据、当天信息预览,语音预报。",
"example": "today"
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "需要查询的城市名称,如:威宁",
"example": "威宁"
},
{
"name": "n",
"type": "integer",
"required": false,
"description": "当此值为空时返回关键词城市列表,不为空时则返回对应列表内需要的城市当天天气。",
"example": "1"
}
]
{"openapi":"3.1.1","info":{"title":"天气助手","description":"依托先进的数据抓取与处理技术,该天气搜索接口可精准获取全国城市及区县的天气数据。不仅能实时返回气温、湿度、气压、风速风向、空气质量指数(AQI)、紫外线强度等15 + 维度天气指数,还提供当日天气全景预览,包含 6 时实时天气状况、白天与夜间天气变化、最高最低温走势、气象预警提示(如暴雨、大风预警及防御指南)等内容。同时,支持一键生成MP3 格式语音预报,开发者通过简单集成即可实现 APP 语音报天气、智能设备语音交互功能,满足天气查询工具、生活服务平台等多场景开发需求,以丰富且精准的天气信息,为用户带来优质的使用体验。","version":"1.0.0"},"paths":{"/v1/tq_tips.php":{"get":{"summary":"天气助手","description":"依托先进的数据抓取与处理技术,该天气搜索接口可精准获取全国城市及区县的天气数据。不仅能实时返回气温、湿度、气压、风速风向、空气质量指数(AQI)、紫外线强度等15 + 维度天气指数,还提供当日天气全景预览,包含 6 时实时天气状况、白天与夜间天气变化、最高最低温走势、气象预警提示(如暴雨、大风预警及防御指南)等内容。同时,支持一键生成MP3 格式语音预报,开发者通过简单集成即可实现 APP 语音报天气、智能设备语音交互功能,满足天气查询工具、生活服务平台等多场景开发需求,以丰富且精准的天气信息,为用户带来优质的使用体验。","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","example":"today"},"description":"天气类型:weather、today,分别对应超详细天气数据、当天信息预览,语音预报。"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"威宁"},"description":"需要查询的城市名称,如:威宁"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"当此值为空时返回关键词城市列表,不为空时则返回对应列表内需要的城市当天天气。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"天气助手","description":"依托先进的数据抓取与处理技术,该天气搜索接口可精准获取全国城市及区县的天气数据。不仅能实时返回气温、湿度、气压、风速风向、空气质量指数(AQI)、紫外线强度等15 + 维度天气指数,还提供当日天气全景预览,包含 6 时实时天气状况、白天与夜间天气变化、最高最低温走势、气象预警提示(如暴雨、大风预警及防御指南)等内容。同时,支持一键生成MP3 格式语音预报,开发者通过简单集成即可实现 APP 语音报天气、智能设备语音交互功能,满足天气查询工具、生活服务平台等多场景开发需求,以丰富且精准的天气信息,为用户带来优质的使用体验。","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","example":"today"},"description":"天气类型:weather、today,分别对应超详细天气数据、当天信息预览,语音预报。"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"威宁"},"description":"需要查询的城市名称,如:威宁"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"当此值为空时返回关键词城市列表,不为空时则返回对应列表内需要的城市当天天气。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://api.suol.cc","description":"当前访问入口(http)"}]}
{
"code": 200,
"data": {
"weather": "今天是8月10日星期日,一起来看天气。威宁当前正处于暴雨、雷电预警中。威宁县气象台8月10日3时1分将暴雨黄色预警信号升级为暴雨橙色预警信号:预计未来3小时,我县新发及周边乡镇将出现雷雨天气,雷雨中可能伴有短时强降水、大风等强对流天气,可能会造成雷电灾害事故,远离大树、电杆或有突出金属物地方,请相关单位及个人做好雷电应对工作。今晨6时,威宁晴,气温19℃,南风4-5级,相对湿度85%。预计,今天白天多云,最高气温26℃,微风,今天夜间阵雨,最低气温17.3℃,微风。空气质量方面,今晨6时,AQI指数13,空气质量为优,未来24小时空气质量持续良好。近期重点天气提示:降水提醒:预计今天有多云转阵雨、明天有中雨转阵雨。雨天驾车出行注意减速慢行,并与前车保持安全距离,以免发生意外。",
"audio": "http://xiaoapi.cn/v1/log/tq_tips_101260704_today.mp3"
},
"tips": "慕名API:http://xiaoapi.cn"
}
暂无详细文档
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
// 结果将在此处显示
生效日期:2026年7月22日
欢迎使用 xiaoapi.cn(以下简称"本平台")。在使用本平台提供的 API 服务(以下简称"本服务")前,请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务,即视为您已阅读、理解并同意接受本声明的全部内容。
本平台作为 API 技术服务的提供方,仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界,督促用户合法、合规地使用本服务,防范违法违规行为的发生。
用户在使用本服务时,明确禁止从事以下行为:
在法律法规允许的最大范围内,本平台对以下情形不承担责任:
因用户违反本声明或相关法律法规,导致本平台及其关联方、合作方遭受任何损失(包括但不限于赔偿款、罚款、律师费、诉讼费等),用户同意向本平台及相关方承担全部赔偿责任。
本平台有权根据法律法规变化、业务调整或监管要求,随时修改本声明。修改后的声明将在本页面公布,自公布之日起生效。您继续使用本服务,即视为接受更新后的声明。
如您对本声明有任何疑问,或发现他人存在违规使用本服务的行为,欢迎通过本平台公示的联系方式与我们联系,我们将及时处理。