<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" xml:lang="zh"><generator uri="https://jekyllrb.com/" version="4.4.1">Jekyll</generator><link href="https://blog.qweather.com/atom.xml" rel="self" type="application/atom+xml" /><link href="https://blog.qweather.com/" rel="alternate" type="text/html" hreflang="zh" /><updated>2026-08-12T13:45:02+08:00</updated><id>https://blog.qweather.com/atom.xml</id><title type="html">和风天气博客</title><subtitle>和风天气官方博客和新闻站点</subtitle><entry xml:lang="zh"><title type="html">全新天气预报 API 已发布</title><link href="https://blog.qweather.com/post/new-weather-api-v1/" rel="alternate" type="text/html" title="全新天气预报 API 已发布" /><published>2026-07-31T00:00:00+08:00</published><updated>2026-07-31T00:00:00+08:00</updated><id>https://blog.qweather.com/post/new-weather-api-v1</id><content type="html" xml:base="https://blog.qweather.com/post/new-weather-api-v1/"><![CDATA[<p><img src="https://dl.qweather.com/sites/blog/upload/new-weather-api-v1.jpg" alt="全新天气预报API" /></p>

<p>我们很高兴宣布，<strong><a href="https://dev.qweather.com/docs/api/weather/">全新天气预报 API</a></strong> 正式发布。</p>

<p>新一代天气预报服务不只是对传统模式预报的简单计算，而是一套完整的智能气象处理系统。通过精细化降尺度、多模型融合、实时站点同化、AI算法和不确定性评估，我们将复杂的数值模式结果转化为统一、稳定且易于集成的天气数据，为开发者提供更精细、更丰富、更准确的天气预报数据。</p>

<h2 id="多源融合">多源融合</h2>

<p>天气预报具有天然的不确定性，任何单一数值模式都可能在特定区域、季节或天气过程中出现偏差。</p>

<p>我们自主研发的多模式融合系统，会综合全球模式、区域模式及集合预报结果，并根据地区、季节、天气类型和预报时效动态计算模型权重。系统持续评估不同模式在温度、降水、风速、云量和强对流等要素上的历史表现，自动选择更适合当前天气场景的模型组合，而不是采用固定权重或简单平均。</p>

<h2 id="实时站点同化">实时站点同化</h2>

<p>全新的天气预报 API 引入了更加完善的地面气象站数据同化流程。系统实时比较观测数据与模式背景场，对温度、湿度、气压、风速和降水等要素进行偏差分析，并将订正量合理扩展到周边网格。随着新观测数据不断进入系统，预报结果会持续滚动更新，使短时预报能够更快响应天气变化。</p>

<h2 id="ai-的应用">AI 的应用</h2>

<p>我们自主研发的AI和机器学习算法应用于天气现象和偏差订正，对多维气象要素进行联合判断，并根据区域气候特征动态调整识别阈值。</p>

<p>对于强降水和雷暴天气，算法还会结合多模型一致性、集合预报概率、对流不稳定能量、水汽输送及历史相似天气过程，提高复杂天气现象识别的稳定性。</p>

<p>对于模型的长期系统性错误或站点故障数据，创建分区域、分季节、分天气类型和分预报时效的AI订正模型，综合分析历史模式预报、气象站实况、近期误差趋势、地形特征及时间周期，对不同气象要素分别进行校正。</p>

<h2 id="1-公里物理分辨率">1 公里物理分辨率</h2>

<p>全新天气 API 提供最高 <strong>1 公里物理分辨率</strong>的精细化天气预报。相比传统的中低分辨率预报产品，新版本能够更准确地描述城市、山地、海岸、湖泊及复杂地形附近的天气差异，更好地识别局地降水、温度梯度、风场变化和强对流天气。对于地形起伏明显或城市热岛效应显著的区域，更高分辨率意味着预报结果不再局限于大范围平均状态，而是能够更加接近用户所在位置的真实天气。</p>

<h2 id="未来10天逐小时预报">未来10天逐小时预报</h2>

<p>全新天气 API 提供未来<strong>10天逐小时预报</strong>，一次获取最长240小时的连续天气变化。更长的逐小时预报既能满足近期出行和运营安排，也能为中期生产计划、风险评估和自动化决策预留更多时间。</p>

<h2 id="更丰富的气象要素">更丰富的气象要素</h2>

<p>除了温度、湿度、风和降水等核心数据，新版 API 还提供了更丰富的气象要素，帮助开发者从更多维度理解天气过程。无论是日常天气应用，还是能源、农业、交通、户外活动等专业场景，都可以根据实际需求构建更完整的天气服务。</p>

<p>现在，开发者可以通过统一接口获取未来 10 天、最高 1 公里分辨率的天气预报，为产品和业务构建更精细、更准确、更可靠的气象能力。</p>

<p>➡️ <a href="https://dev.qweather.com/docs/api/weather/">访问天气 API v1</a></p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[全新天气预报API正式发布，以1公里物理分辨率、更多气象要素和多源智能融合技术，提供未来10天逐小时天气预报。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/new-weather-api-v1.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/new-weather-api-v1.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">天气预报 Web API v7 将停止服务</title><link href="https://blog.qweather.com/announce/weather-forecast-webapi-v7-discontinue/" rel="alternate" type="text/html" title="天气预报 Web API v7 将停止服务" /><published>2026-07-31T00:00:00+08:00</published><updated>2026-07-31T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/weather-forecast-webapi-v7-discontinue</id><content type="html" xml:base="https://blog.qweather.com/announce/weather-forecast-webapi-v7-discontinue/"><![CDATA[<p>根据我们的产品升级计划，旧版本天气预报 Web API v7 将于<strong>2027年8月1日停止服务</strong>，请仍在使用该版本的开发者尽快迁移至全新天气 API v1。</p>

<h2 id="影响范围">影响范围</h2>

<p>本次调整涉及 Web API v7 中的天气预报相关服务，请参考下列表格：</p>

<table>
  <thead>
    <tr>
      <th>API</th>
      <th>endpoint</th>
      <th>停服日期</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>格点天气预报</td>
      <td><code class="language-plaintext highlighter-rouge">/v7/grid-weather/now</code><br /><code class="language-plaintext highlighter-rouge">/v7/grid-weather/{days}</code><br /><code class="language-plaintext highlighter-rouge">/v7/grid-weather/{hours}</code></td>
      <td>2027-08-01</td>
    </tr>
    <tr>
      <td>城市天气预报</td>
      <td><code class="language-plaintext highlighter-rouge">/v7/weather/now</code><br /><code class="language-plaintext highlighter-rouge">/v7/weather/{days}</code><br /><code class="language-plaintext highlighter-rouge">/v7/weather/{hours}</code></td>
      <td>2027-08-01</td>
    </tr>
  </tbody>
</table>

<p>自2027年8月1日起，相关旧版本接口将不再提供数据，尚未完成迁移的应用可能无法继续获取天气预报。</p>

<h2 id="升级至天气-api-v1">升级至天气 API v1</h2>

<p><a href="/post/new-weather-api-v1/">全新天气预报 API v1</a> 提供了更精细、更丰富、更准确的天气预报能力，主要升级包括：</p>

<ul>
  <li>物理分辨率提升至1公里</li>
  <li>提供更丰富的气象要素</li>
  <li>综合使用多种数值预报模型、气象站点观测同化、AI和机器学习技术</li>
  <li>支持未来10天逐小时天气预报</li>
</ul>

<p>详情参考<a href="https://dev.qweather.com/docs/api/weather/">天气预报 v1 开发文档</a></p>

<h2 id="迁移建议">迁移建议</h2>

<p>请在停止服务日期前完成以下工作：</p>

<ol>
  <li>根据天气 API v1 开发文档调整请求地址、参数和身份认证</li>
  <li>检查新旧版本的数据结构、字段、单位和时间格式</li>
  <li>在测试环境中对新旧预报结果进行并行验证</li>
  <li>更新依赖旧版本接口的应用、自动化任务和监控规则</li>
  <li>在2027年8月1日前完成正式环境切换</li>
</ol>

<p>建议尽早开始迁移并预留充分的测试时间，避免旧版本停止服务后影响业务运行。如有疑问，请登录控制台<a href="https://console.qweather.com/support/ticket">提交工单</a>。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[根据我们的产品升级计划，旧版本天气预报 Web API v7 将于2027年8月1日停止服务，请仍在使用该版本的开发者尽快迁移至全新天气 API v1。 影响范围 本次调整涉及 Web API v7 中的天气预报相关服务，请参考下列表格： API endpoint 停服日期 格点天气预报 /v7/grid-weather/now/v7/grid-weather/{days}/v7/grid-weather/{hours} 2027-08-01 城市天气预报 /v7/weather/now/v7/weather/{days}/v7/weather/{hours} 2027-08-01 自2027年8月1日起，相关旧版本接口将不再提供数据，尚未完成迁移的应用可能无法继续获取天气预报。 升级至天气 API v1 全新天气预报 API v1 提供了更精细、更丰富、更准确的天气预报能力，主要升级包括： 物理分辨率提升至1公里 提供更丰富的气象要素 综合使用多种数值预报模型、气象站点观测同化、AI和机器学习技术 支持未来10天逐小时天气预报 详情参考天气预报 v1 开发文档 迁移建议 请在停止服务日期前完成以下工作： 根据天气 API v1 开发文档调整请求地址、参数和身份认证 检查新旧版本的数据结构、字段、单位和时间格式 在测试环境中对新旧预报结果进行并行验证 更新依赖旧版本接口的应用、自动化任务和监控规则 在2027年8月1日前完成正式环境切换 建议尽早开始迁移并预留充分的测试时间，避免旧版本停止服务后影响业务运行。如有疑问，请登录控制台提交工单。]]></summary></entry><entry xml:lang="zh"><title type="html">2026春节假期公告</title><link href="https://blog.qweather.com/announce/cny2026/" rel="alternate" type="text/html" title="2026春节假期公告" /><published>2026-02-05T00:00:00+08:00</published><updated>2026-02-05T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/cny2026</id><content type="html" xml:base="https://blog.qweather.com/announce/cny2026/"><![CDATA[<p>🐎马年快乐🎉</p>

<p>和风天气将从2月10日-2月26日处于春节假期，所有API业务都将正常运行，然而在此期间一些客户服务的响应将延迟：</p>

<ul>
  <li>2月10日-2月26日，暂停开具发票。</li>
  <li>2月14日-2月23日，支持工单的回复速度将延长至48小时（已经签约技术支持协议的客户除外）。</li>
  <li>2月14日-2月26日，邮件和电话技术支持将暂停。</li>
  <li>2月14日-2月23日，企业开发者的认证和变更的审核将暂停。</li>
</ul>

<p>感谢开发者们的理解和支持，再次祝福马年快乐，身体健康，恭喜发财🧧</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[🐎马年快乐🎉 和风天气将从2月10日-2月26日处于春节假期，所有API业务都将正常运行，然而在此期间一些客户服务的响应将延迟： 2月10日-2月26日，暂停开具发票。 2月14日-2月23日，支持工单的回复速度将延长至48小时（已经签约技术支持协议的客户除外）。 2月14日-2月26日，邮件和电话技术支持将暂停。 2月14日-2月23日，企业开发者的认证和变更的审核将暂停。 感谢开发者们的理解和支持，再次祝福马年快乐，身体健康，恭喜发财🧧]]></summary></entry><entry xml:lang="zh"><title type="html">天气预警 Web API v7 停止服务</title><link href="https://blog.qweather.com/announce/weather-warning-webapi-v7-discontinue/" rel="alternate" type="text/html" title="天气预警 Web API v7 停止服务" /><published>2025-10-24T00:00:00+08:00</published><updated>2025-10-24T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/weather-warning-webapi-v7-discontinue</id><content type="html" xml:base="https://blog.qweather.com/announce/weather-warning-webapi-v7-discontinue/"><![CDATA[<p>根据我们的产品升级计划，从<strong>2026年10月1日</strong>起，天气预警Web API v7版本将停止运行。</p>

<h3 id="关闭服务的计划">关闭服务的计划</h3>

<p>我们将计划分为两个阶段逐步关闭已弃用的天气预警API：</p>

<p><strong>2025年10月25日起</strong>，新注册的开发者将无法使用上述弃用版本天气预警API</p>

<p><strong>2026年10月1日起</strong>，弃用版本天气预警API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。</p>

<h3 id="升级至新版本">升级至新版本</h3>

<p>新版本的实时天气预警 v1 已发布，提供了更丰富、更规范的预警数据服务，包括：</p>

<ul>
  <li>支持全球100+国家或地区</li>
  <li>空间分辨率提升至 1 公里</li>
  <li>支持防御指南和预警标准</li>
  <li>支持更详细的预警信息</li>
  <li>支持取消和升级预警信息</li>
</ul>

<p>详情参考<a href="https://dev.qweather.com/docs/api/warning/weather-alert/">实时天气预警 v1 开发文档</a></p>

<h3 id="字段映射">字段映射</h3>

<table>
  <thead>
    <tr>
      <th>Webapi v7（旧）</th>
      <th>全新 v1</th>
      <th>说明</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.id</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.id</code></td>
      <td>预警唯一标识</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.sender</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.senderName</code></td>
      <td>预警发布机构</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.pubTime</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.issuedTime</code></td>
      <td>发布时间</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.title</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.headline</code></td>
      <td>预警标题</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.startTime</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.effectiveTime</code></td>
      <td>预警开始时间</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.endTime</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.expireTime</code></td>
      <td>预警结束时间</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.status</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.messageType.code</code></td>
      <td>预警状态</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.severity</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.severity</code></td>
      <td>严重程度</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.severityColor</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.color.code</code> + RGBA</td>
      <td>预警颜色</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.type</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.eventType.code</code></td>
      <td>事件类型代码</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.typeName</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.eventType.name</code></td>
      <td>事件类型名称</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.text</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.description</code></td>
      <td>预警详细描述</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.related</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.messageType.supersedes</code></td>
      <td>被取代的预警 ID 列表</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.urgency</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.urgency</code></td>
      <td>紧迫程度</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.certainty</code></td>
      <td><code class="language-plaintext highlighter-rouge">alerts.certainty</code></td>
      <td>确定性</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">warning.level</code></td>
      <td>（已移除）</td>
      <td> </td>
    </tr>
    <tr>
      <td>（无）</td>
      <td><code class="language-plaintext highlighter-rouge">alerts.onsetTime</code></td>
      <td>新增：预警事件生效时间</td>
    </tr>
    <tr>
      <td>（无）</td>
      <td><code class="language-plaintext highlighter-rouge">alerts.criteria</code></td>
      <td>新增：预警触发标准</td>
    </tr>
    <tr>
      <td>（无）</td>
      <td><code class="language-plaintext highlighter-rouge">alerts.instruction</code></td>
      <td>新增：防御指南</td>
    </tr>
    <tr>
      <td>（无）</td>
      <td><code class="language-plaintext highlighter-rouge">alerts.icon</code></td>
      <td>新增：预警图标</td>
    </tr>
    <tr>
      <td>（无）</td>
      <td><code class="language-plaintext highlighter-rouge">alerts.responseTypes</code></td>
      <td>新增：应对方式代码</td>
    </tr>
  </tbody>
</table>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[根据我们的产品升级计划，从2026年10月1日起，天气预警Web API v7版本将停止运行。 关闭服务的计划 我们将计划分为两个阶段逐步关闭已弃用的天气预警API： 2025年10月25日起，新注册的开发者将无法使用上述弃用版本天气预警API 2026年10月1日起，弃用版本天气预警API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。 升级至新版本 新版本的实时天气预警 v1 已发布，提供了更丰富、更规范的预警数据服务，包括： 支持全球100+国家或地区 空间分辨率提升至 1 公里 支持防御指南和预警标准 支持更详细的预警信息 支持取消和升级预警信息 详情参考实时天气预警 v1 开发文档 字段映射 Webapi v7（旧） 全新 v1 说明 warning.id alerts.id 预警唯一标识 warning.sender alerts.senderName 预警发布机构 warning.pubTime alerts.issuedTime 发布时间 warning.title alerts.headline 预警标题 warning.startTime alerts.effectiveTime 预警开始时间 warning.endTime alerts.expireTime 预警结束时间 warning.status alerts.messageType.code 预警状态 warning.severity alerts.severity 严重程度 warning.severityColor alerts.color.code + RGBA 预警颜色 warning.type alerts.eventType.code 事件类型代码 warning.typeName alerts.eventType.name 事件类型名称 warning.text alerts.description 预警详细描述 warning.related alerts.messageType.supersedes 被取代的预警 ID 列表 warning.urgency alerts.urgency 紧迫程度 warning.certainty alerts.certainty 确定性 warning.level （已移除）   （无） alerts.onsetTime 新增：预警事件生效时间 （无） alerts.criteria 新增：预警触发标准 （无） alerts.instruction 新增：防御指南 （无） alerts.icon 新增：预警图标 （无） alerts.responseTypes 新增：应对方式代码]]></summary></entry><entry xml:lang="zh"><title type="html">全新太阳辐射：更高精度更灵活预测</title><link href="https://blog.qweather.com/post/new-solar-radiation-v1/" rel="alternate" type="text/html" title="全新太阳辐射：更高精度更灵活预测" /><published>2025-09-20T00:00:00+08:00</published><updated>2025-09-20T00:00:00+08:00</updated><id>https://blog.qweather.com/post/new-solar-radiation-v1</id><content type="html" xml:base="https://blog.qweather.com/post/new-solar-radiation-v1/"><![CDATA[<p>我们很高兴宣布新版<strong><a href="https://dev.qweather.com/docs/api/solar-radiation/solar-radiation-forecast/">太阳辐照 API</a></strong>正式上线。本次更新围绕光伏与新能源场景的需求，重点提升了预测的时间精度、空间分辨率以及可选输出项。</p>

<h3 id="更灵活的时间分辨率">更灵活的时间分辨率</h3>

<p>全新太阳辐照 API 支持逐<strong>15 分钟、30 分钟或 60 分钟</strong>的预报粒度，覆盖<strong>最长 60 小时</strong>的预测周期。这意味着开发者可以根据实际应用需求，在短期功率预测或中短期调度之间灵活切换。例如，逐 15 分钟的预测更适合短时电力优化，逐小时的预测则适合日内市场或能量管理。</p>

<h3 id="高精度物理分辨率">高精度物理分辨率</h3>

<p>数据源采用物理建模结合再分析校准，空间分辨率提升至 <strong>1 公里</strong>，可显著提升预测的可靠性。</p>

<h3 id="扩展的气象要素">扩展的气象要素</h3>

<p>除了核心的 <strong>DNI、DHI、GHI</strong> 等辐照量之外，全新太阳辐照 API 还提供可选的气象要素输出，包括 <strong>温度、风速、湿度</strong>。这些要素对于辐照到达地表后的修正和光伏功率建模都具有参考价值。例如，温度影响组件效率，风速影响散热条件。</p>

<h3 id="plane-of-array-功能">Plane of Array 功能</h3>

<p>针对光伏用户，我们新增了 <strong>POA（Plane of Array，组件平面辐照量）</strong> 的计算能力。开发者只需指定系统的倾角和方位角，即可获得基于实际光伏组件方位的辐照数据。相比单纯提供水平面辐照量，POA 结果更贴近实际组件接收到的能量，更有利于功率预测与发电性能评估。</p>

<p>新版太阳辐照 API 旨在为开发者和行业用户提供更高精度、更贴近应用的太阳能资源预测能力。我们期待它能帮助您在新能源应用中构建更智能的调度与优化方案。</p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[全新太阳辐照API正式上线。本次更新围绕光伏与新能源场景的需求，重点提升了预测的时间精度、空间分辨率以及可选输出项。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/solar-radiation-v1.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/solar-radiation-v1.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">太阳辐照 Web API v7 停止服务</title><link href="https://blog.qweather.com/announce/solar-radiation-webapi-v7-discontinue/" rel="alternate" type="text/html" title="太阳辐照 Web API v7 停止服务" /><published>2025-09-20T00:00:00+08:00</published><updated>2025-09-20T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/solar-radiation-webapi-v7-discontinue</id><content type="html" xml:base="https://blog.qweather.com/announce/solar-radiation-webapi-v7-discontinue/"><![CDATA[<p>根据我们的产品升级计划，旧版太阳辐照 Web API v7 将于<strong>2026年9月1日停止服务</strong>。</p>

<h3 id="关闭服务的计划">关闭服务的计划</h3>

<p>我们将计划分为两个阶段逐步关闭已弃用的太阳辐照API：</p>

<p><strong>2025年9月20日起</strong>，新注册的开发者将无法使用上述弃用版本太阳辐照API</p>

<p><strong>2026年9月1日起</strong>，弃用版本太阳辐照API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。</p>

<h3 id="升级至新版本">升级至新版本</h3>

<p>新版本的太阳辐照预报 v1 已于近期发布，提供了更丰富、更高精度的辐照数据服务，包括：</p>

<ul>
  <li>时间粒度可选 15、30、60 分钟</li>
  <li>空间分辨率提升至 1 公里，预测结果更精细</li>
  <li>支持可选的天气要素输出（温度、风速、湿度等）</li>
  <li>支持 POA（Plane of Array）阵列平面辐照度计算</li>
</ul>

<p>详情请参考<a href="https://dev.qweather.com/docs/api/solar-radiation/solar-radiation-forecast/">开发文档</a>。</p>

<h3 id="字段映射">字段映射</h3>

<p>新旧版本的辐射字段定义并非完全相同。下表列出关键字段的映射说明，请勿直接使用新字段的返回值替换旧字段。</p>

<table>
  <thead>
    <tr>
      <th>Web API v7（旧）</th>
      <th>全新 v1</th>
      <th>说明</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">net</code></td>
      <td>(无)</td>
      <td><code class="language-plaintext highlighter-rouge">net ≈ ghi × (1 - 地面反照率)</code>，若无法获得实际地表反照率，可取 0.25 进行粗略估算；该经验值不适用于积雪、沙地等高反射地表。</td>
    </tr>
    <tr>
      <td>(无)</td>
      <td><code class="language-plaintext highlighter-rouge">ghi</code></td>
      <td><code class="language-plaintext highlighter-rouge">ghi</code> 表示向下到达水平面的总辐照度<br />转换关系 <code class="language-plaintext highlighter-rouge">ghi ≈ diffuse + direct</code></td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">diffuse</code></td>
      <td><code class="language-plaintext highlighter-rouge">dhi</code></td>
      <td><code class="language-plaintext highlighter-rouge">diffuse</code>和<code class="language-plaintext highlighter-rouge">dhi</code> 均表示散射水平面辐照度</td>
    </tr>
    <tr>
      <td><code class="language-plaintext highlighter-rouge">direct</code></td>
      <td><code class="language-plaintext highlighter-rouge">dni</code></td>
      <td><code class="language-plaintext highlighter-rouge">dni</code> 表示法向直接辐照度，不能直接替代 <code class="language-plaintext highlighter-rouge">direct</code> <br />转换关系 <code class="language-plaintext highlighter-rouge">direct ≈ dni × sin(太阳高度角)</code>，其中太阳高度角小于等于 0° 时取 0。</td>
    </tr>
    <tr>
      <td>(无)</td>
      <td><code class="language-plaintext highlighter-rouge">solarAngle</code></td>
      <td>新增太阳方位角与高度角</td>
    </tr>
    <tr>
      <td>(无)</td>
      <td><code class="language-plaintext highlighter-rouge">weather</code></td>
      <td>新增可选气象要素</td>
    </tr>
    <tr>
      <td>(无)</td>
      <td><code class="language-plaintext highlighter-rouge">poa</code></td>
      <td>新增可选 POA 阵列平面辐照度</td>
    </tr>
  </tbody>
</table>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[根据我们的产品升级计划，旧版太阳辐照 Web API v7 将于2026年9月1日停止服务。 关闭服务的计划 我们将计划分为两个阶段逐步关闭已弃用的太阳辐照API： 2025年9月20日起，新注册的开发者将无法使用上述弃用版本太阳辐照API 2026年9月1日起，弃用版本太阳辐照API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。 升级至新版本 新版本的太阳辐照预报 v1 已于近期发布，提供了更丰富、更高精度的辐照数据服务，包括： 时间粒度可选 15、30、60 分钟 空间分辨率提升至 1 公里，预测结果更精细 支持可选的天气要素输出（温度、风速、湿度等） 支持 POA（Plane of Array）阵列平面辐照度计算 详情请参考开发文档。 字段映射 新旧版本的辐射字段定义并非完全相同。下表列出关键字段的映射说明，请勿直接使用新字段的返回值替换旧字段。 Web API v7（旧） 全新 v1 说明 net (无) net ≈ ghi × (1 - 地面反照率)，若无法获得实际地表反照率，可取 0.25 进行粗略估算；该经验值不适用于积雪、沙地等高反射地表。 (无) ghi ghi 表示向下到达水平面的总辐照度转换关系 ghi ≈ diffuse + direct diffuse dhi diffuse和dhi 均表示散射水平面辐照度 direct dni dni 表示法向直接辐照度，不能直接替代 direct 转换关系 direct ≈ dni × sin(太阳高度角)，其中太阳高度角小于等于 0° 时取 0。 (无) solarAngle 新增太阳方位角与高度角 (无) weather 新增可选气象要素 (无) poa 新增可选 POA 阵列平面辐照度]]></summary></entry><entry xml:lang="zh"><title type="html">潮流API停止服务</title><link href="https://blog.qweather.com/announce/currents-api-discontinued/" rel="alternate" type="text/html" title="潮流API停止服务" /><published>2025-08-31T00:00:00+08:00</published><updated>2025-08-31T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/currents-api-discontinued</id><content type="html" xml:base="https://blog.qweather.com/announce/currents-api-discontinued/"><![CDATA[<p>根据我们的发展计划，<a href="https://dev.qweather.com/docs/api/ocean/currents/">潮流API</a>将于2025年11月1日停止服务。</p>

<p>从2025年9月1日起，潮流API将不记录任何费用，返回的数据可能有一定延迟，开发者有60天的时间可以调整业务。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[根据我们的发展计划，潮流API将于2025年11月1日停止服务。 从2025年9月1日起，潮流API将不记录任何费用，返回的数据可能有一定延迟，开发者有60天的时间可以调整业务。]]></summary></entry><entry xml:lang="zh"><title type="html">公共API域名变更为API Host</title><link href="https://blog.qweather.com/announce/public-api-domain-change-to-api-host/" rel="alternate" type="text/html" title="公共API域名变更为API Host" /><published>2025-06-15T00:00:00+08:00</published><updated>2025-06-15T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/public-api-domain-change-to-api-host</id><content type="html" xml:base="https://blog.qweather.com/announce/public-api-domain-change-to-api-host/"><![CDATA[<p>和风天气在2025年4月1日发布了API Host功能，用于替代原公共API域名，这项功能提供了更高的API安全等级。对于原公共API域名，我们将陆续停止服务：</p>

<ul>
  <li><code class="language-plaintext highlighter-rouge">devapi.qweather.com</code> 该域名地址将于2026年1月1日停止服务</li>
  <li><code class="language-plaintext highlighter-rouge">api.qweather.com</code> 该域名地址将于2026年6月1日停止服务</li>
  <li><code class="language-plaintext highlighter-rouge">geoapi.qweather.com</code> 该域名地址将于2026年6月1日停止服务</li>
</ul>

<p>如果你当前还在使用上述API域名，为了你的帐号和API安全，请在停止服务日期之前更换为你的API Host。API Host可以在<a href="https://console.qweather.com/setting">控制台设置</a>中查看或参考<a href="https://dev.qweather.com/docs/configuration/api-host/">API Host文档</a>。</p>

<h2 id="如何变更">如何变更</h2>

<p><strong>api.qweather.com</strong></p>

<p>复制你的API Host，替换程序中所有<code class="language-plaintext highlighter-rouge">api.qweather.com</code></p>

<p><strong>devapi.qweather.com</strong></p>

<p>复制你的API Host，替换程序中所有<code class="language-plaintext highlighter-rouge">devapi.qweather.com</code></p>

<p><strong>geoapi.qweather.com</strong></p>

<p>替换GeoAPI的公共域名地址略微复杂一些，除了替换域名还需要替换部分路径。</p>

<p>首先复制你的API Host，替换程序中所有<code class="language-plaintext highlighter-rouge">geoapi.qweather.com</code>，之后将原路径中的版本号从 <code class="language-plaintext highlighter-rouge">v2</code> 变更为 <code class="language-plaintext highlighter-rouge">geo/v2</code>。</p>

<h2 id="变更示例">变更示例</h2>

<p>假设你的API Host是<code class="language-plaintext highlighter-rouge">abc.def.qweatherapi.com</code>，完整变更示例如下：</p>

<table>
  <thead>
    <tr>
      <th>变更前的公共API地址</th>
      <th>变更后的API地址</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>api.qweather.com</td>
      <td>abc.def.qweatherapi.com</td>
    </tr>
    <tr>
      <td>devapi.qweather.com</td>
      <td>abc.def.qweatherapi.com</td>
    </tr>
    <tr>
      <td>geoapi.qweather.com/v2/city/lookup</td>
      <td>abc.def.qweatherapi.com/geo/v2/city/lookup</td>
    </tr>
    <tr>
      <td>geoapi.qweather.com/v2/city/top</td>
      <td>abc.def.qweatherapi.com/geo/v2/city/top</td>
    </tr>
    <tr>
      <td>geoapi.qweather.com/v2/poi/lookup</td>
      <td>abc.def.qweatherapi.com/geo/v2/poi/lookup</td>
    </tr>
    <tr>
      <td>geoapi.qweather.com/v2/poi/range</td>
      <td>abc.def.qweatherapi.com/geo/v2/poi/range</td>
    </tr>
  </tbody>
</table>

<p>如果你对此变更有任何疑问，请登录控制台<a href="https://console.qweather.com/support/ticket">提交工单</a>。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[和风天气在2025年4月1日发布了API Host功能，用于替代原公共API域名，这项功能提供了更高的API安全等级。对于原公共API域名，我们将陆续停止服务： devapi.qweather.com 该域名地址将于2026年1月1日停止服务 api.qweather.com 该域名地址将于2026年6月1日停止服务 geoapi.qweather.com 该域名地址将于2026年6月1日停止服务 如果你当前还在使用上述API域名，为了你的帐号和API安全，请在停止服务日期之前更换为你的API Host。API Host可以在控制台设置中查看或参考API Host文档。 如何变更 api.qweather.com 复制你的API Host，替换程序中所有api.qweather.com devapi.qweather.com 复制你的API Host，替换程序中所有devapi.qweather.com geoapi.qweather.com 替换GeoAPI的公共域名地址略微复杂一些，除了替换域名还需要替换部分路径。 首先复制你的API Host，替换程序中所有geoapi.qweather.com，之后将原路径中的版本号从 v2 变更为 geo/v2。 变更示例 假设你的API Host是abc.def.qweatherapi.com，完整变更示例如下： 变更前的公共API地址 变更后的API地址 api.qweather.com abc.def.qweatherapi.com devapi.qweather.com abc.def.qweatherapi.com geoapi.qweather.com/v2/city/lookup abc.def.qweatherapi.com/geo/v2/city/lookup geoapi.qweather.com/v2/city/top abc.def.qweatherapi.com/geo/v2/city/top geoapi.qweather.com/v2/poi/lookup abc.def.qweatherapi.com/geo/v2/poi/lookup geoapi.qweather.com/v2/poi/range abc.def.qweatherapi.com/geo/v2/poi/range 如果你对此变更有任何疑问，请登录控制台提交工单。]]></summary></entry><entry xml:lang="zh"><title type="html">控制台API上线</title><link href="https://blog.qweather.com/post/console-api-released/" rel="alternate" type="text/html" title="控制台API上线" /><published>2025-05-25T00:00:00+08:00</published><updated>2025-05-25T00:00:00+08:00</updated><id>https://blog.qweather.com/post/console-api-released</id><content type="html" xml:base="https://blog.qweather.com/post/console-api-released/"><![CDATA[<p>控制台API现已发布上线，可以帮助开发者实时监控账户财务状态和API调用情况。</p>

<h2 id="-核心功能">🚀 核心功能</h2>

<h3 id="财务汇总api">财务汇总API</h3>

<p>财务汇总提供如下数据：</p>

<ul>
  <li>帐号可用额度</li>
  <li>昨日、本月和上次出账以来的应计费用</li>
  <li>待处理的账单</li>
  <li>节省计划和资源包使用状态</li>
</ul>

<p>➡️ <a href="https://dev.qweather.com/docs/api/console/finance/">财务汇总API的开发文档</a></p>

<h3 id="请求量统计api">请求量统计API</h3>

<p>请求量统计提供如下数据：</p>

<ul>
  <li>最近24小时各个API的成功请求次数</li>
  <li>最近24小时各个API的失败请求次数</li>
  <li>支持根据项目和凭据过滤数据</li>
</ul>

<p>➡️ <a href="https://dev.qweather.com/docs/api/console/stats/">请求量统计API的开发文档</a></p>

<h2 id="-权限与安全">🔒 权限与安全</h2>

<p>出于安全和账户隐私考虑，​​控制台API 默认不可用​​，需手动在​​凭据管理​​中开通权限：</p>

<ol>
  <li><a href="https://console.qweather.com/project">前往控制台-项目管理</a></li>
  <li>点击需要启用控制台API的凭据</li>
  <li>向下滑动至“控制台权限”</li>
  <li>勾选需要启用的控制台API权限</li>
  <li>点击“保存”按钮</li>
</ol>

<h2 id="-最佳实践">📝 最佳实践</h2>

<p>财务API：</p>

<ul>
  <li>定期检查消费情况，避免超额扣费</li>
  <li>根据应计费用自定义消费预警</li>
  <li>根据账单应付日期设置付款提醒</li>
  <li>查看节省计划或资源包的剩余量</li>
</ul>

<p>请求量统计API：</p>

<ul>
  <li>监控异常流量，优化API调用策略</li>
  <li>检查和修复错误请求</li>
</ul>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[控制台API现已发布上线，可以帮助开发者实时监控账户财务状态和API调用情况。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/console-api.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/console-api.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">空气质量Web API v7即将在2026年中关闭</title><link href="https://blog.qweather.com/announce/aqi-webapi-v7-is-about-to-close-in-mid-2026/" rel="alternate" type="text/html" title="空气质量Web API v7即将在2026年中关闭" /><published>2025-05-10T00:00:00+08:00</published><updated>2025-05-10T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/aqi-webapi-v7-is-about-to-close-in-mid-2026</id><content type="html" xml:base="https://blog.qweather.com/announce/aqi-webapi-v7-is-about-to-close-in-mid-2026/"><![CDATA[<p>根据我们的API迭代规则，从<strong>2026年6月1日</strong>起，空气质量Web API v7版本将停止运行。</p>

<h3 id="弃用的版本">弃用的版本</h3>

<p>弃用的空气质量API包括：</p>

<ul>
  <li><a href="https://dev.qweather.com/docs/api/air/air-now/">/v7/air/now</a> 实时空气质量（Web API v7）</li>
  <li><a href="https://dev.qweather.com/docs/api/air/air-daily-forecast/">/v7/air/5d</a> 空气质量每日预报（Web API v7）</li>
</ul>

<p>如果你仍在使用上述弃用版本API，请安排合理的时间进行升级。</p>

<h3 id="关闭服务的计划">关闭服务的计划</h3>

<p>我们将计划分为两个阶段逐步关闭已弃用的空气质量API：</p>

<p><strong>2025年10月1日起</strong>，新注册的开发者将无法使用上述弃用版本空气质量API</p>

<p><strong>2026年6月1日起</strong>，弃用版本空气质量API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。</p>

<h3 id="升级至新版本">升级至新版本</h3>

<p>新版本的空气质量API v1版本已于2023年12月30日发布，支持全世界100+国家的空气质量数据，提供了更丰富、更高精度的数据服务，目前的升级覆盖率已经超过70%。</p>

<ul>
  <li><a href="https://dev.qweather.com/docs/api/air-quality/air-current/">/airquality/v1/current</a> 实时空气质量（新）</li>
  <li><a href="https://dev.qweather.com/docs/api/air-quality/air-hourly-forecast/">/airquality/v1/hourly</a> 空气质量每小时预报（新）</li>
  <li><a href="https://dev.qweather.com/docs/api/air-quality/air-daily-forecast/">/airquality/v1/daily</a> 空气质量每日预报（新）</li>
</ul>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[根据我们的API迭代规则，从2026年6月1日起，空气质量Web API v7版本将停止运行。 弃用的版本 弃用的空气质量API包括： /v7/air/now 实时空气质量（Web API v7） /v7/air/5d 空气质量每日预报（Web API v7） 如果你仍在使用上述弃用版本API，请安排合理的时间进行升级。 关闭服务的计划 我们将计划分为两个阶段逐步关闭已弃用的空气质量API： 2025年10月1日起，新注册的开发者将无法使用上述弃用版本空气质量API 2026年6月1日起，弃用版本空气质量API将对所有开发者关闭并停止服务，所有开发者将无法再访问上述弃用版本获取数据，包括使用API、SDK。 升级至新版本 新版本的空气质量API v1版本已于2023年12月30日发布，支持全世界100+国家的空气质量数据，提供了更丰富、更高精度的数据服务，目前的升级覆盖率已经超过70%。 /airquality/v1/current 实时空气质量（新） /airquality/v1/hourly 空气质量每小时预报（新） /airquality/v1/daily 空气质量每日预报（新）]]></summary></entry><entry xml:lang="zh"><title type="html">账单预警功能停止服务</title><link href="https://blog.qweather.com/announce/bill-alert-discontinued/" rel="alternate" type="text/html" title="账单预警功能停止服务" /><published>2025-05-10T00:00:00+08:00</published><updated>2025-05-10T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/bill-alert-discontinued</id><content type="html" xml:base="https://blog.qweather.com/announce/bill-alert-discontinued/"><![CDATA[<p>控制台账单预警功能（消费预警、可用额度预警）目前已经不符合当前业务需求，且难以实现高度个性化定制，经综合评估，我们计划从 <strong>2025年7月1日</strong> 起正式停止账单预警服务，届时开发者将不会再收到此类账单预警的短信和电子邮件。</p>

<p>作为代替，开发者现在可以使用财务汇总API获取更精准、全面的财务信息，并根据自身需求灵活自行设置提醒规则。​</p>

<p>了解<a href="https://dev.qweather.com/docs/api/console/finance/">财务汇总API</a>和<a href="https://dev.qweather.com/docs/api/console/stats/">请求量统计API</a>。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[控制台账单预警功能（消费预警、可用额度预警）目前已经不符合当前业务需求，且难以实现高度个性化定制，经综合评估，我们计划从 2025年7月1日 起正式停止账单预警服务，届时开发者将不会再收到此类账单预警的短信和电子邮件。 作为代替，开发者现在可以使用财务汇总API获取更精准、全面的财务信息，并根据自身需求灵活自行设置提醒规则。​ 了解财务汇总API和请求量统计API。]]></summary></entry><entry xml:lang="zh"><title type="html">SDK v4版本下线预告</title><link href="https://blog.qweather.com/announce/sdk-v4-discontinued/" rel="alternate" type="text/html" title="SDK v4版本下线预告" /><published>2025-03-30T00:00:00+08:00</published><updated>2025-03-30T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/sdk-v4-discontinued</id><content type="html" xml:base="https://blog.qweather.com/announce/sdk-v4-discontinued/"><![CDATA[<p><a href="https://dev.qweather.com/docs/configuration/ios-sdk-config/">iOS SDK v5.0</a> 和 <a href="https://dev.qweather.com/docs/configuration/android-sdk-config/">Android SDK v5.0</a> 已经在本月发布上线，根据我们的迭代规则，SDK v4.x版本将在2026年12月31日之前停止服务。</p>

<h2 id="涉及的版本">涉及的版本</h2>

<ul>
  <li>iOS SDK v4.x</li>
  <li>Android SDK v4.x</li>
</ul>

<h2 id="停止服务的计划">停止服务的计划</h2>

<p>2026年12月31日</p>

<h2 id="需要做什么">需要做什么</h2>

<p>如果你正在使用 SDK 4.x 版本，请尽快升级到 SDK 5.x 版本。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[iOS SDK v5.0 和 Android SDK v5.0 已经在本月发布上线，根据我们的迭代规则，SDK v4.x版本将在2026年12月31日之前停止服务。 涉及的版本 iOS SDK v4.x Android SDK v4.x 停止服务的计划 2026年12月31日 需要做什么 如果你正在使用 SDK 4.x 版本，请尽快升级到 SDK 5.x 版本。]]></summary></entry><entry xml:lang="zh"><title type="html">计费方式调整</title><link href="https://blog.qweather.com/announce/billing-update/" rel="alternate" type="text/html" title="计费方式调整" /><published>2025-03-10T00:00:00+08:00</published><updated>2025-03-10T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/billing-update</id><content type="html" xml:base="https://blog.qweather.com/announce/billing-update/"><![CDATA[<p>从2025年4月1日起，我们将调整计费模式，包括更改结算周期、新增信用额度等。通过本次计费方式的调整，开发者不再需要预付金额，仅在每个月初根据账单金额支付上个月的API请求费用，这将进一步简化计费规则，让开发者可以更加专注于产品本身。</p>

<h2 id="结算方式">结算方式</h2>

<p>自动支付方式将变更为定期支付，即从当前按小时实时结算变更为按月结算，请参考下列表个了解结算方式的不同：</p>

<table>
  <thead>
    <tr>
      <th>新计费模式</th>
      <th>原计费模式</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>根据每小时应计费用按月结算，开发者只需要每月初根据账单支付上月费用即可。</td>
      <td>根据每小时应计费用实时结算，开发者需要时刻关注帐号可用额度，超出后将被停止服务</td>
    </tr>
  </tbody>
</table>

<p>此项调整不涉及已经是定期支付的企业开发者。</p>

<h2 id="信用额度">信用额度</h2>

<p>我们授予所有开发者信用额度，开发者无需预存费用，只需要按月支付实际发生的API请求费用。开发者的信用额度是动态变化的，随着用户账单的支付、请求量的增减而变化。</p>

<h2 id="月中账单">月中账单</h2>

<p>通常，我们将在每个月1-5日出具上个月API请求量账单，如果开发者在当月的API请求费用超过了其信用额度，我们将出具月中账单，开发者需要在月中账单支付日期之前完成支付，以便恢复信用额度。逾期未支付的，API服务将被暂停。</p>

<h2 id="生效日期">生效日期</h2>

<p>2025年4月1日。</p>

<h2 id="需要做什么">需要做什么</h2>

<p>本次调整是自动化的，开发者只需要关注我们发出的账单，在付款日期前支付即可。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[从2025年4月1日起，我们将调整计费模式，包括更改结算周期、新增信用额度等。通过本次计费方式的调整，开发者不再需要预付金额，仅在每个月初根据账单金额支付上个月的API请求费用，这将进一步简化计费规则，让开发者可以更加专注于产品本身。 结算方式 自动支付方式将变更为定期支付，即从当前按小时实时结算变更为按月结算，请参考下列表个了解结算方式的不同： 新计费模式 原计费模式 根据每小时应计费用按月结算，开发者只需要每月初根据账单支付上月费用即可。 根据每小时应计费用实时结算，开发者需要时刻关注帐号可用额度，超出后将被停止服务 此项调整不涉及已经是定期支付的企业开发者。 信用额度 我们授予所有开发者信用额度，开发者无需预存费用，只需要按月支付实际发生的API请求费用。开发者的信用额度是动态变化的，随着用户账单的支付、请求量的增减而变化。 月中账单 通常，我们将在每个月1-5日出具上个月API请求量账单，如果开发者在当月的API请求费用超过了其信用额度，我们将出具月中账单，开发者需要在月中账单支付日期之前完成支付，以便恢复信用额度。逾期未支付的，API服务将被暂停。 生效日期 2025年4月1日。 需要做什么 本次调整是自动化的，开发者只需要关注我们发出的账单，在付款日期前支付即可。]]></summary></entry><entry xml:lang="zh"><title type="html">Console V4即将发布</title><link href="https://blog.qweather.com/post/console-v4/" rel="alternate" type="text/html" title="Console V4即将发布" /><published>2025-03-05T00:00:00+08:00</published><updated>2025-03-05T00:00:00+08:00</updated><id>https://blog.qweather.com/post/console-v4</id><content type="html" xml:base="https://blog.qweather.com/post/console-v4/"><![CDATA[<p><img src="https://dl.qweather.com/sites/blog/upload/console-v4-banner.jpg" alt="" /></p>

<p>我们很高兴的宣布，在2025年4月1日将发布和风天气开发服务控制台（Console）V4正式版。本次更新带来了大量新功能、新的计费方式以及增强的安全策略。</p>

<h2 id="新功能">新功能</h2>

<p>我们对控制台的功能和UI进行了大幅优化，包括：</p>

<ul>
  <li>项目和凭据：优化创建流程和展示逻辑，更便于阅读。</li>
  <li>数据统计：新增更多时间维度的统计，新增错误请求统计。</li>
  <li>账单支付：新增在电子邮件中直接对账单进行支付。</li>
  <li>节省计划：新的购买流程，现在可以指定节省计划的生效日期。</li>
  <li>增值税发票：新增申请发票时的额外备注。</li>
  <li>技术支持：新的工单系统和常见问题解答，开发者可以更轻松的找到问题答案。</li>
  <li>价格计算器：现在可以一次性计算多个价格分组的数据。</li>
  <li>UI：新增深色主题，并为移动设备进行了更广泛的适配。</li>
</ul>

<h2 id="安全策略">安全策略</h2>

<p>提高安全性是我们不断追求的目标，没有最安全，只有更安全。</p>

<h3 id="独立api-host">独立API Host</h3>

<p>独立API Host是控制台 V4最重要的更新。基于我们广泛的云服务设施以及全新的技术架构，我们为每个开发者提供隔离的、共享硬件的、可弹性扩展的虚拟空间，API服务将独立的运行在每个虚拟空间中。开发者将获得一个唯一、独立的API地址用于请求数据，这将极大的提高开发者数据的安全性以及API性能。</p>

<p>独立API Host功能将在本次更新后陆续向开发者推送，原API地址（api.qweather.com和devapi.qweather.com）预计在2026年起逐步退出，开发者可以根据自己的时间表随时更新到新的API Host。</p>

<h3 id="敏感操作的身份验证">敏感操作的身份验证</h3>

<p>我们对于敏感操作（例如删除凭据）进行了额外的身份验证（短信或邮件），确保其行为是你本人。</p>

<h3 id="api使用限制">API使用限制</h3>

<p>对凭据增加API限制，如果你只使用和风天气开发服务的指定API，我们建议你开启API限制。</p>

<h3 id="使用你的名字">使用你的名字</h3>

<p>本次更新后，开发者可以设置自己的名字，之后我们将在所有与你沟通的邮件中使用你的名字称呼你，而不再使用类似“你好 abc@edf.com”、“亲爱的用户”或者“先生/女士”。这将有助于防范网络钓鱼或模仿和风天气的虚假、欺诈邮件。</p>

<h3 id="双因素身份验证">双因素身份验证</h3>

<p>我们预计将在今年下半年推出双因素身份验证，进一步加强开发者的帐号安全。</p>

<h2 id="计费方式的更新">计费方式的更新</h2>

<p>我们简化了按量计费的流程，开发者无需预付任何费用，根据当月实际请求量在次月初支付。</p>

<h3 id="订阅调整">订阅调整</h3>

<p>原标准订阅将被新的按量计费订阅代替，以便适应本次计费规则的调整。原免费订阅也将合并到新的按量计费订阅，参考<a href="https://blog.qweather.com/announce/free-subscription-service-update/">免费服务和订阅调整</a>。</p>

<h3 id="信用额度">信用额度</h3>

<p>所有开发者都将被授予一定的信用额度，开发者无需预存费用，只需要按月支付实际发生的API请求费用。当你的帐号余额小于等于0时，将消耗你的信用额度。在你支付完账单后，信用额度将恢复。信用额度会随着请求量、支付历史记录而动态的变化，一般来说，按时支付账单将逐步提高信用额度。</p>

<h3 id="月中账单">月中账单</h3>

<p>通常，我们将在每个月1-5日出具上个月API请求量账单，如果开发者在当月的API请求费用超过了其信用额度，我们将出具月中账单，开发者需要在按时支付，以便恢复信用额度。逾期未支付的，API服务将被暂停。</p>

<h2>🚀</h2>

<p>以上就是控制台V4版本的主要更新内容，2025年4月1日后我们将陆续向开发者进行推送，任何问题和意见请随时联系我们！</p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[即将发布和风天气控制台V4正式版。本次更新带来了大量新功能、新的计费方式以及增强的安全策略。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/console-v4.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/console-v4.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">免费服务和订阅调整</title><link href="https://blog.qweather.com/announce/free-subscription-service-update/" rel="alternate" type="text/html" title="免费服务和订阅调整" /><published>2025-03-01T00:00:00+08:00</published><updated>2025-03-01T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/free-subscription-service-update</id><content type="html" xml:base="https://blog.qweather.com/announce/free-subscription-service-update/"><![CDATA[<p>从2025年4月1日起，我们将对免费政策进行调整，这将有助于开发者更加高效、便捷和公平的使用API服务。</p>

<h2 id="免费订阅变更">免费订阅变更</h2>

<p>免费订阅将与标准订阅合并为按量计费订阅，与原标准订阅一样遵守<a href="https://dev.qweather.com/docs/finance/billing-and-payment/">计费</a>和<a href="https://dev.qweather.com/docs/finance/pricing/">定价</a>规则。原免费订阅包含的1000次/天免费API请求额度（包括企业和个人开发者的额外免费额度）将被移除，取而代之的是按量计费阶梯价中的免费价格档位。这一变化旨在为开发者带来更灵活、适合自身使用情况的计费选择，即开发者可以充分利用免费请求额度，并在有需求时按照实际请求量支付费用。</p>

<p><strong>更多免费请求量</strong></p>

<p>免费额度从之前的按天计算改为按月计算，并增加了免费额度，从而提高了免费额度的利用率，避免某一天突然超过免费额度或当天免费额度没有用尽的情况，满足开发者动态请求次数的需求。</p>

<p><strong>服务性能提升</strong></p>

<p>免费订阅升级为按量计费订阅后，将提高带宽能力、服务器性能和稳定性，同时支持自动路由功能，可以自动并高速的访问和风天气在世界各地的数据中心。</p>

<p><strong>更多可用免费数据</strong></p>

<p>使用新的按量计费订阅后，根据按量计费定价分组，开发者将获得更多种类的免费数据，例如时光机、更长时长的预报等。这些数据在一定数量内完全免费。</p>

<p><strong>许可协议变更</strong></p>

<p>原免费订阅对应的<a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a>将更改为<a href="https://www.qweather.com/terms/developers-eula">和风天气开发者许可协议</a>，这意味着开发者可获取更广泛更灵活的许可。</p>

<p><strong>对比</strong></p>

<p>请参考下方表格，了解本次免费政策调整前后的对比：</p>

<table>
  <thead>
    <tr>
      <th> </th>
      <th>新按量计费订阅</th>
      <th>原免费订阅</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>免费额度</td>
      <td>每月50000次</td>
      <td>每日1000次</td>
    </tr>
    <tr>
      <td>重置周期</td>
      <td>每月，请求量分布更加灵活</td>
      <td>每天</td>
    </tr>
    <tr>
      <td>可用数据</td>
      <td>更多种类和更长的预报时长</td>
      <td>仅限免费订阅可用数据</td>
    </tr>
    <tr>
      <td>超出免费额度</td>
      <td>可正常获取数据，仅需支付超出部分的费用</td>
      <td>禁止数据请求，产品将无法更新</td>
    </tr>
    <tr>
      <td>性能和规格</td>
      <td>更高性能带宽与服务器<br />更高稳定性<br />支持全球自动路由</td>
      <td>无SLA<br />仅限中国节点</td>
    </tr>
    <tr>
      <td>许可</td>
      <td>开发者许可协议</td>
      <td>CC BY-SA 4.0</td>
    </tr>
  </tbody>
</table>

<h2 id="适用范围">适用范围</h2>

<p>本次调整适用于所有用户，包括个人开发者和企业开发者。</p>

<h2 id="生效日期">生效日期</h2>

<p>2025年4月1日。</p>

<h2 id="需要做什么">需要做什么</h2>

<p>本次调整是自动化的，开发者无需进行特别操作。在本次升级后，我们将陆续提供新的API地址用于替换原免费订阅的地址（devapi.qweather.com），开发者将收到详细的说明文档并提供至少6个月的时间进行替换，在此期间，开发者依然可以按原有方式使用API服务。</p>

<h2 id="注意事项">注意事项</h2>

<p>在免费订阅升级为按量计费订阅后，当超出免费额度后，开发者可能需要支付取超出部分的费用，因此开发者需要检查当前的程序是否会出现超额请求量的情况。同时，关于更高效、正确的使用API，我们建议阅读<a href="https://dev.qweather.com/docs/best-practices/security-guidelines/">安全指南</a>和<a href="https://dev.qweather.com/docs/best-practices/optimize-requests/">优化请求</a>。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[从2025年4月1日起，我们将对免费政策进行调整，这将有助于开发者更加高效、便捷和公平的使用API服务。 免费订阅变更 免费订阅将与标准订阅合并为按量计费订阅，与原标准订阅一样遵守计费和定价规则。原免费订阅包含的1000次/天免费API请求额度（包括企业和个人开发者的额外免费额度）将被移除，取而代之的是按量计费阶梯价中的免费价格档位。这一变化旨在为开发者带来更灵活、适合自身使用情况的计费选择，即开发者可以充分利用免费请求额度，并在有需求时按照实际请求量支付费用。 更多免费请求量 免费额度从之前的按天计算改为按月计算，并增加了免费额度，从而提高了免费额度的利用率，避免某一天突然超过免费额度或当天免费额度没有用尽的情况，满足开发者动态请求次数的需求。 服务性能提升 免费订阅升级为按量计费订阅后，将提高带宽能力、服务器性能和稳定性，同时支持自动路由功能，可以自动并高速的访问和风天气在世界各地的数据中心。 更多可用免费数据 使用新的按量计费订阅后，根据按量计费定价分组，开发者将获得更多种类的免费数据，例如时光机、更长时长的预报等。这些数据在一定数量内完全免费。 许可协议变更 原免费订阅对应的CC BY-SA 4.0将更改为和风天气开发者许可协议，这意味着开发者可获取更广泛更灵活的许可。 对比 请参考下方表格，了解本次免费政策调整前后的对比：   新按量计费订阅 原免费订阅 免费额度 每月50000次 每日1000次 重置周期 每月，请求量分布更加灵活 每天 可用数据 更多种类和更长的预报时长 仅限免费订阅可用数据 超出免费额度 可正常获取数据，仅需支付超出部分的费用 禁止数据请求，产品将无法更新 性能和规格 更高性能带宽与服务器更高稳定性支持全球自动路由 无SLA仅限中国节点 许可 开发者许可协议 CC BY-SA 4.0 适用范围 本次调整适用于所有用户，包括个人开发者和企业开发者。 生效日期 2025年4月1日。 需要做什么 本次调整是自动化的，开发者无需进行特别操作。在本次升级后，我们将陆续提供新的API地址用于替换原免费订阅的地址（devapi.qweather.com），开发者将收到详细的说明文档并提供至少6个月的时间进行替换，在此期间，开发者依然可以按原有方式使用API服务。 注意事项 在免费订阅升级为按量计费订阅后，当超出免费额度后，开发者可能需要支付取超出部分的费用，因此开发者需要检查当前的程序是否会出现超额请求量的情况。同时，关于更高效、正确的使用API，我们建议阅读安全指南和优化请求。]]></summary></entry><entry xml:lang="zh"><title type="html">开发服务降价</title><link href="https://blog.qweather.com/post/update-pricing-253/" rel="alternate" type="text/html" title="开发服务降价" /><published>2025-02-10T00:00:00+08:00</published><updated>2025-02-10T00:00:00+08:00</updated><id>https://blog.qweather.com/post/update-pricing-253</id><content type="html" xml:base="https://blog.qweather.com/post/update-pricing-253/"><![CDATA[<p>随着和风天气API请求量的增长以及先进预报模型的应用，我们的运营和生产数据的成本也逐步降低。我们相信合理的利润将增强我们与开发者的合作关系，有助于降低开发者的使用成本，减少开发者对费用增加的担忧，因此从2025年3月1日起，我们将调整当前的价格策略，以便显著的降低API的请求费用。</p>

<p>本次价格策略的调整包括新设计的价格分组、单次请求费用、每月初始固定免费请求和节省计划，生效时间为3月1日，面向所有开发者用户。</p>

<h2 id="价格分组">价格分组</h2>

<p>我们对开发者使用最频繁的API进行了重新分组，这有助于将这些热门API合并在一起计算阶梯价格，从而降低成本。</p>

<p>例如你在一个月内请求了60万次天气预报和60万次空气质量，这将分别触发各自的Tier 2价格，而在3月1日之后，这两种API将合并按照120万次请求计算（达到Tier 3价格）。</p>

<p>新的价格分组包括：</p>

<table>
  <thead>
    <tr>
      <th>分组</th>
      <th>包括的API</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>天气和环境</td>
      <td><a href="https://dev.qweather.com/docs/api/weather/">天气预报</a>，<a href="https://dev.qweather.com/docs/api/geoapi/">GeoAPI</a>，<a href="https://dev.qweather.com/docs/api/minutely/">分钟预报</a>，<a href="https://dev.qweather.com/docs/api/grid-weather/">格点天气</a>，<a href="https://dev.qweather.com/docs/api/warning/">预警</a>，<a href="https://dev.qweather.com/docs/api/indices/">天气指数</a>，<a href="https://dev.qweather.com/docs/api/air-quality/">空气质量</a>，<a href="https://dev.qweather.com/docs/api/time-machine/">时光机</a>，<a href="https://dev.qweather.com/docs/api/astronomy/">天文</a></td>
    </tr>
    <tr>
      <td>台风和海洋</td>
      <td><a href="https://dev.qweather.com/docs/api/tropical-cyclone/">热带气旋</a>，<a href="https://dev.qweather.com/docs/api/ocean/">海洋数据</a></td>
    </tr>
    <tr>
      <td>太阳辐照</td>
      <td><a href="https://dev.qweather.com/docs/api/solar-radiation/">太阳辐照</a></td>
    </tr>
  </tbody>
</table>

<h2 id="价格">价格</h2>

<p>我们大范围的降低了所有API的请求费用，平均降幅达到35%，并且额外提供了每个月初始5万次的免费请求额度。</p>

<p>以下是新的API定价：</p>

<p><strong>天气和环境</strong></p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-5万次</td>
      <td>CNY 0</td>
    </tr>
    <tr>
      <td>之后的95万次</td>
      <td>CNY 0.0007</td>
    </tr>
    <tr>
      <td>之后的400万次</td>
      <td>CNY 0.0005</td>
    </tr>
    <tr>
      <td>之后的500万次</td>
      <td>CNY 0.00035</td>
    </tr>
    <tr>
      <td>之后的4000万次</td>
      <td>CNY 0.00015</td>
    </tr>
    <tr>
      <td>之后的5000万次</td>
      <td>CNY 0.0001</td>
    </tr>
  </tbody>
</table>

<p><strong>台风和海洋</strong></p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-100万次</td>
      <td>CNY 0.003</td>
    </tr>
    <tr>
      <td>之后的400万次</td>
      <td>CNY 0.0025</td>
    </tr>
    <tr>
      <td>超过500万次</td>
      <td>CNY 0.0015</td>
    </tr>
  </tbody>
</table>

<p><strong>太阳辐照</strong></p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-10万次</td>
      <td>CNY 0.3</td>
    </tr>
    <tr>
      <td>超过10万次</td>
      <td>CNY 0.2</td>
    </tr>
  </tbody>
</table>

<h2 id="节省计划">节省计划</h2>

<p>对于节省计划，我们将进行如下调整：</p>

<ul>
  <li>节省计划一年期的节省系数调整为0.7，在3月1日之前购买的节省计划的节省系数不变。</li>
  <li>从即日起将取消三年期节省计划的销售，已购买的三年期节省计划可继续使用。</li>
</ul>

<h2 id="最后">最后</h2>

<p>和风天气将持续致力于先进气象算法的开发和应用，为广大开发者和企业用户提供高效、精准、低成本的气象服务。</p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[和风天气API的快速增长和先进预报模型的应用，推动了API请求费用的大幅度降价。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/price-down-253.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/price-down-253.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">2025年春节放假通知</title><link href="https://blog.qweather.com/announce/2025-cny-holiday-notice/" rel="alternate" type="text/html" title="2025年春节放假通知" /><published>2025-01-14T00:00:00+08:00</published><updated>2025-01-14T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/2025-cny-holiday-notice</id><content type="html" xml:base="https://blog.qweather.com/announce/2025-cny-holiday-notice/"><![CDATA[<p>2025年春季即将到来，提前祝愿广大开发者与我们的合作伙伴新春快乐🧨、生意兴隆💰、合家欢乐🎉、身体健康💪</p>

<p>在春节来临之际，我们也将逐步开始放假，放假期间的技术支持和客户服务将延迟或暂停，具体如下：</p>

<ul>
  <li>客服电话：2025年1月15日-2月12日暂停服务</li>
  <li>电子邮件：2025年1月20日-2月12日响应速度将延长至72小时，1月28日-2月5日暂停服务</li>
  <li>工单：2025年1月20日-2月5日响应速度将延长至72小时</li>
  <li>发票：2025年1月20日-2月12日暂停服务</li>
</ul>

<p>如果你是我们的协议客户，请与你的商务经理联系。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[2025年春季即将到来，提前祝愿广大开发者与我们的合作伙伴新春快乐🧨、生意兴隆💰、合家欢乐🎉、身体健康💪 在春节来临之际，我们也将逐步开始放假，放假期间的技术支持和客户服务将延迟或暂停，具体如下： 客服电话：2025年1月15日-2月12日暂停服务 电子邮件：2025年1月20日-2月12日响应速度将延长至72小时，1月28日-2月5日暂停服务 工单：2025年1月20日-2月5日响应速度将延长至72小时 发票：2025年1月20日-2月12日暂停服务 如果你是我们的协议客户，请与你的商务经理联系。]]></summary></entry><entry xml:lang="zh"><title type="html">对API KEY请求量的限制</title><link href="https://blog.qweather.com/announce/request-volume-limit-for-api-key/" rel="alternate" type="text/html" title="对API KEY请求量的限制" /><published>2024-10-30T00:00:00+08:00</published><updated>2024-10-30T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/request-volume-limit-for-api-key</id><content type="html" xml:base="https://blog.qweather.com/announce/request-volume-limit-for-api-key/"><![CDATA[<p>为了推动API安全等级的不断提升，保护开发者隐私和利益，和风天气API的身份认证方式将逐步从<a href="https://dev.qweather.com/docs/authentication/apikey/">API KEY</a>迁移至<a href="https://dev.qweather.com/docs/authentication/jwt/">JWT(JSON Web Token)</a>。我们计划自2027年2月1日起，限制使用API KEY（包括基于API KEY的数字签名）的每日请求量。这一限制措施可以确保入侵者即使获取到了API KEY也无法在短时间内请求大量数据而对开发者的利益造成损失。</p>

<p>我们提供了15个月的过渡期，在此期间开发者仍然可以不受限制的使用API KEY请求数据，尽管如此，我们强烈建议开发者使用<a href="https://dev.qweather.com/docs/authentication/jwt/">JWT身份认证</a>的方式请求API，这将带来更高的安全等级并且不会受到任何限制。</p>

<h2 id="生效时间">生效时间</h2>

<p>2027年2月1日</p>

<h2 id="限制规则">限制规则</h2>

<table>
  <thead>
    <tr>
      <th>认证方式</th>
      <th>限制</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>API KEY</td>
      <td>1000次请求/天</td>
    </tr>
    <tr>
      <td>JWT(JSON Web Token)</td>
      <td>无限制</td>
    </tr>
  </tbody>
</table>

<p>请注意，当使用API KEY超过每日请求量限制后，将返回403或429状态码，对于超过请求量限制后依然发送大量请求的，我们将采取封禁IP或冻结帐号的措施。</p>

<h2 id="例外">例外</h2>

<p>如果你是我们的协议用户，请与你的客户经理联系。</p>

<p>我们希望通过这一步步的优化措施，帮助开发者从根本上提高API的安全性和可控性。</p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[为了推动API安全等级的不断提升，保护开发者隐私和利益，和风天气API的身份认证方式将逐步从API KEY迁移至JWT(JSON Web Token)。我们计划自2027年2月1日起，限制使用API KEY（包括基于API KEY的数字签名）的每日请求量。这一限制措施可以确保入侵者即使获取到了API KEY也无法在短时间内请求大量数据而对开发者的利益造成损失。 我们提供了15个月的过渡期，在此期间开发者仍然可以不受限制的使用API KEY请求数据，尽管如此，我们强烈建议开发者使用JWT身份认证的方式请求API，这将带来更高的安全等级并且不会受到任何限制。 生效时间 2027年2月1日 限制规则 认证方式 限制 API KEY 1000次请求/天 JWT(JSON Web Token) 无限制 请注意，当使用API KEY超过每日请求量限制后，将返回403或429状态码，对于超过请求量限制后依然发送大量请求的，我们将采取封禁IP或冻结帐号的措施。 例外 如果你是我们的协议用户，请与你的客户经理联系。 我们希望通过这一步步的优化措施，帮助开发者从根本上提高API的安全性和可控性。]]></summary></entry><entry xml:lang="zh"><title type="html">JWT身份认证已发布</title><link href="https://blog.qweather.com/post/jwt-is-now-supported/" rel="alternate" type="text/html" title="JWT身份认证已发布" /><published>2024-10-29T00:00:00+08:00</published><updated>2024-10-29T00:00:00+08:00</updated><id>https://blog.qweather.com/post/jwt-is-now-supported</id><content type="html" xml:base="https://blog.qweather.com/post/jwt-is-now-supported/"><![CDATA[<p>为了提升数据传输过程中的安全性，保障用户信息的隐私，和风天气API服务将在10月30日正式支持<strong>JWT（JSON Web Token）</strong>身份认证方式。JWT将为开发者显著的提高安全性、降低数据泄露和未经授权访问的风险。</p>

<h2 id="jwt更安全的身份认证">JWT更安全的身份认证</h2>

<p>在传统的API身份认证中，<strong>API KEY</strong>经常用作一种简单、便捷的认证方法。然而，API KEY仅提供有限的访问控制，容易在传输过程中被拦截，随着前端和移动应用的发展，使用API KEY将带来明显的安全隐患。<strong>JWT（JSON Web Token）</strong>通过将用户信息、安全密钥等有效地封装到一个自包含的令牌中，并在每次请求时生成独特的签名，提供了更高安全等级的身份认证。</p>

<p>JWT的优势包括：</p>

<ul>
  <li><strong>防篡改</strong>：JWT通过数字签名来验证消息的完整性，有效防止数据篡改。</li>
  <li><strong>过期控制</strong>：JWT可以设置有效时间，防止长时间有效的Token带来风险。</li>
  <li><strong>不易泄露</strong>：JWT的密钥由开发者保管，任何人包括和风天气均无法伪造开发者的签名。</li>
  <li><strong>更方便的集成</strong>： JWT是一种行业标准，被广泛支持，易于集成到各种应用程序中。</li>
</ul>

<p>这些优势使得JWT成为API身份认证的首选，也符合现代化应用对数据隐私和传输安全的需求。</p>

<h2 id="如何使用jwt">如何使用JWT</h2>

<p>关于在和风天气开发服务中使用JWT，请参考<a href="https://dev.qweather.com/docs/authentication/jwt/">身份认证-JSON Web Token</a>。实际上，你不需要为生成JWT编写完整的代码，大部分开发语言都可以使用第三方库生成和验证JWT，参考<a href="https://jwt.io/libraries">JWT.io</a>。</p>

<h2 id="应用限制与来源控制">应用限制与来源控制</h2>

<p>为更好地管理API的请求来源，本次更新中我们还引入了<strong>API应用请求限制</strong>功能，开发者可以自行设定API的访问来源。此功能允许开发者为各个应用设置请求来源白名单，如指定的域名、IP地址或移动应用。通过这种来源限制，您可以进一步控制API的调用安全，降低潜在风险，避免不明或恶意来源的请求，从而保障API的可靠性。参考<a href="https://dev.qweather.com/docs/best-practices/security-guidelines/#security-restriction">安全指南-设置安全限制</a>。</p>

<h2 id="最后">最后</h2>

<p>JWT的推出标志着我们对用户数据安全承诺的进一步升级，我们相信，通过JWT认证和API应用请求限制功能的双重保障，将为您的API提供更全面、更安全的保护！</p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[为了提升数据传输过程中的安全性，保障用户信息的隐私，和风天气API服务将在10月30日正式推JWT（JSON Web Token）认证方式。JWT将为开发者和用户提供一种更安全、便捷的身份认证机制，有效降低数据泄露和未经授权访问的风险。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/jwt-key.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/jwt-key.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">天气预警新增泰国与沙特阿拉伯</title><link href="https://blog.qweather.com/announce/new-th-sa-warning/" rel="alternate" type="text/html" title="天气预警新增泰国与沙特阿拉伯" /><published>2024-10-20T00:00:00+08:00</published><updated>2024-10-20T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/new-th-sa-warning</id><content type="html" xml:base="https://blog.qweather.com/announce/new-th-sa-warning/"><![CDATA[<p>即日起，天气预警支持的国家新增泰国与沙特阿拉伯。</p>

<h2 id="更新时间">更新时间</h2>

<p>2024年10月20日</p>

<h2 id="新增预警">新增预警</h2>

<ul>
  <li>泰国:2501,2502</li>
  <li>沙特阿拉伯：2521-2527</li>
</ul>

<p>全部预警类型请参考 <a href="https://dev.qweather.com/docs/resource/warning-info/">https://dev.qweather.com/docs/resource/warning-info/</a></p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[即日起，天气预警支持的国家新增泰国与沙特阿拉伯。 更新时间 2024年10月20日 新增预警 泰国:2501,2502 沙特阿拉伯：2521-2527 全部预警类型请参考 https://dev.qweather.com/docs/resource/warning-info/]]></summary></entry></feed>