Skip to content

API 版本说明

彩云天气 API 提供了多个版本,不同版本在接口功能、认证方式和数据格式方面存在差异。本文档旨在帮助您了解各版本的特点,以便为您的项目选择合适的 API 版本。

版本概览

版本状态说明
v3Beta最新架构,持续更新;但部分接口尚未完善,请使用 v2.6 版本替代
v2.6Stable稳定版本,推荐使用
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 在认证凭证的传递位置上存在差异,详细认证文档请参见:认证与鉴权