GET 请求基础格式
心知天气的 API 请求均为 HTTP GET 方法，基本 URL 结构如下：
https://api.seniverse.com/v3/weather/{接口类型}.json?key={你的API密钥}&location={位置}&language={语言}&unit={单位}
关键参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
key |
是 | 你的 API 密钥（从心知天气控制台获取） |
location |
是 | 位置参数，支持城市名（如 beijing）、经纬度（如 93:116.40）或 ID |
language |
否 | 返回语言，默认 zh-Hans（中文），可选 en（英文） |
unit |
否 | 单位制，默认 c（摄氏度），可选 f（华氏度） |
常用接口示例
实时天气
GET https://api.seniverse.com/v3/weather/now.json?key=YOUR_API_KEY&location=beijing&language=zh-Hans&unit=c
逐日天气预报（3天）
GET https://api.seniverse.com/v3/weather/daily.json?key=YOUR_API_KEY&location=shanghai&days=3
生活指数
GET https://api.seniverse.com/v3/life/suggestion.json?key=YOUR_API_KEY&location=guangzhou
完整 cURL 示例
通过命令行工具测试（替换 YOUR_API_KEY）：
curl "https://api.seniverse.com/v3/weather/now.json?key=YOUR_API_KEY&location=beijing&language=zh-Hans"
返回结果示例（JSON）：
{
"results": [{
"location": {"name": "北京"},
"now": {
"text": "晴",
"temperature": "23",
"humidity": "40%"
}
}]
}
注意事项
-
API 密钥保护
- 切勿在前端代码（如 JavaScript）中暴露密钥，应在后端服务器发起请求。
- 每日免费调用限额：个人版 500 次/天（具体以控制台为准）。
-
错误处理
常见错误响应：401：API 密钥无效404：位置不存在429：请求超限
-
编码规范
- 位置参数需进行 URL 编码（如
北京→%E5%8C%97%E4%BA%AC）。 - 建议使用 HTTPS 确保数据传输安全。
- 位置参数需进行 URL 编码（如
最佳实践
- 多位置查询：用 分隔多个位置（如
location=beijing|shanghai）。 - 语言适配：海外地区建议用
language=en获取英文数据。 - 缓存机制：对频繁请求的数据做本地缓存，减少 API 调用。
官方文档参考
- 完整文档：心知天气 API 文档
- 控制台（获取密钥）：心知天气控制台
引用说明：本文内容依据心知天气官方文档编写，数据接口规范以心知天气开发者平台最新版本为准。
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/6195.html
