开发文档 · 华风爱科天气 API

概述

华风爱科由中国气象局华风集团与 AccuWeather 于 2015 年合资成立，依托近十年打磨的天气 API 系统，为海内外用户提供稳定、高可用的气象数据服务。本文档汇总 11 项 REST 接口的能力说明、接入步骤与全局约定，帮助开发者完成 Key 申请与集成。

完成实名认证后开通 30 天标准能力试用，标准测试 Key 每日可免费调用 500 次（5 QPS）；完整接入规范见开发标准与合规。

注册获取 API Key 浏览接口地图
7 亿+
国内用户
3 亿+
海外用户
500 亿+
日均天气请求
11 项
REST API 接口

AI 产品 · 天气 MCP

面向 Claude、Cursor 等 AI 客户端的标准化天气能力调用，提供 17 个 Tool（标准 openAPI Key 8 个 + 高阶 JV Key 9 个）。无需手写 HTTP 请求，配置 JSON 即可让 AI 回答天气问题。

查看 MCP 产品文档 控制台体验

快速入门

  1. 注册开发者账号并完成认证，在控制台创建应用、获取 API Key（标准测试 Key 开通 30 天试用，每日 500 次免费调用（5 QPS））。
  2. 可先在 示例中心 在线调试接口、查看可视化演示，再对照本文档接入。
  3. 通过 定位搜索 API 获取目标地点的 Location Key，供后续天气接口使用。
  4. 携带 API Key 调用 实况天气 API 等接口；建议通过 Header X-Gw-API-Key 传递密钥，详见各接口文档。

全局接口约定 (Global Conventions)

平台所有 API 接口在设计上均遵循以下通用规范：

字段 说明
接口协议HTTPS（强制加密传输）
数据格式JSON（UTF-8 编码）
请求方式GET
接口域名openapi.weathercn.com
鉴权方式OpenAPI Key（URL 参数 apikey 或 Header X-Gw-API-Key）
请求额度与限频标准测试 Key 开通 30 天 试用，每日 500 次 免费额度（5 QPS）；超额或超频返回 403 / 429。企业用户可定制配额。
时间标准ISO 8601，含时区，示例 2026-07-23T14:11:37+08:00
坐标系WGS84（GPS 标准）；中国大陆 GeoPosition 支持 GCJ-02
单位制公制（Metric）与英制（Imperial）并行返回

接口域名与认证 (Endpoints & Auth)

本文档所有接口均通过 https://openapi.weathercn.com 访问，使用应用管理中的 OpenAPI Key 鉴权（URL 参数 apikey 或 Header X-Gw-API-Key）。各接口路径、参数与返回字段见上方接口地图中的独立文档。

建议通过 HTTP Header X-Gw-API-Key 传递密钥，避免出现在 URL 与访问日志中。接入规范详见 开发标准与合规。