API 版本说明
彩云天气 API 提供了多个版本,不同版本在接口功能、认证方式和数据格式方面存在差异。本文档旨在帮助您了解各版本的特点,以便为您的项目选择合适的 API 版本。
版本概览
| 版本 | 状态 | 说明 |
|---|---|---|
| v3 | Beta | 最新架构,持续更新;但部分接口尚未完善,请使用 v2.6 版本替代 |
| v2.6 | Stable | 稳定版本,推荐使用 |
| v2.5 | 历史版本 | 已停止维护,建议迁移至 v2.6 或 v3 |
| v2.4 | 历史版本 | 已停止维护,建议迁移至 v2.6 或 v3 |
| v2.3 | 历史版本 | 已停止维护,建议迁移至 v2.6 或 v3 |
| v2.2 | 历史版本 | 已停止维护,建议迁移至 v2.6 或 v3 |
| v1 | 历史版本 | 已停止维护,但部分接口仅 v1 提供 |
各版本支持的接口列表请参考左侧 sidebar(侧边栏),侧边栏中的接口列表为最新且最准确的版本。
提示
通过侧边栏访问的接口文档中,文档内 URL 的版本即为该接口的最新版本。
重要提示
版本间的接口差异:
- v3 版本未包含部分接口,这些接口仅在 v2.6 版本中提供(如综合数据接口等)
- v3/v2.6 版本未包含部分接口,这些接口仅在 v1 版本中提供(如土壤温湿度、多要素图层、社会化观测反馈、卫星图层等)
请根据您的具体需求选择合适的 API 版本。如需了解各版本接口的详细情况,请参考左侧侧边栏中的接口列表。
认证方式对比
不同版本的 API 在认证凭证的传递位置上存在差异,详细认证文档请参见:认证与鉴权