<?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-03-30T18:14:16+08:00</updated><id>https://blog.qweather.com/atom.xml</id><title type="html">和风天气博客</title><subtitle>和风天气官方博客和新闻站点</subtitle><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">全新太阳辐射：更高精度，更灵活预测</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">潮流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><entry xml:lang="zh"><title type="html">天气预警新增沙特与泰国</title><link href="https://blog.qweather.com/post/weather-warning-sa-th/" rel="alternate" type="text/html" title="天气预警新增沙特与泰国" /><published>2024-10-15T00:00:00+08:00</published><updated>2024-10-15T00:00:00+08:00</updated><id>https://blog.qweather.com/post/weather-warning-sa-th</id><content type="html" xml:base="https://blog.qweather.com/post/weather-warning-sa-th/"><![CDATA[<p>天气预警API将在2024年10月20日新增支持的国家：沙特阿拉伯与泰国。</p>

<p><strong>泰国</strong></p>

<table>
  <thead>
    <tr>
      <th>代码</th>
      <th>预警类型</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>2501</td>
      <td>大雨</td>
    </tr>
    <tr>
      <td>2502</td>
      <td>暴雨</td>
    </tr>
  </tbody>
</table>

<p><strong>沙特阿拉伯</strong></p>

<table>
  <thead>
    <tr>
      <th>代码</th>
      <th>预警类型</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>2521</td>
      <td>中雨</td>
    </tr>
    <tr>
      <td>2522</td>
      <td>雨</td>
    </tr>
    <tr>
      <td>2523</td>
      <td>大雨</td>
    </tr>
    <tr>
      <td>2524</td>
      <td>雾</td>
    </tr>
    <tr>
      <td>2525</td>
      <td>扬尘</td>
    </tr>
    <tr>
      <td>2526</td>
      <td>大风</td>
    </tr>
    <tr>
      <td>2527</td>
      <td>浮尘</td>
    </tr>
  </tbody>
</table>

<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="dev" /><summary type="html"><![CDATA[天气预警新增支持的国家：沙特阿拉伯与泰国。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/warning-update-sa-th.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/warning-update-sa-th.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry xml:lang="zh"><title type="html">开发服务价格调整（2411）</title><link href="https://blog.qweather.com/announce/update-pricing-2411/" rel="alternate" type="text/html" title="开发服务价格调整（2411）" /><published>2024-10-12T00:00:00+08:00</published><updated>2024-10-12T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/update-pricing-2411</id><content type="html" xml:base="https://blog.qweather.com/announce/update-pricing-2411/"><![CDATA[<p>从2024年11月1日起，和风天气开发服务的价格将进行如下调整，降低了部分单价并对于大量请求的用户增加了新的阶梯价格。</p>

<p>天气服务</p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
      <th>原价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-30万次</td>
      <td>CNY 0.001</td>
      <td>CNY 0.001</td>
    </tr>
    <tr>
      <td>之后的70万次</td>
      <td>CNY 0.00088</td>
      <td>CNY 0.0009</td>
    </tr>
    <tr>
      <td>之后的400万次</td>
      <td>CNY 0.0007</td>
      <td>CNY 0.0007</td>
    </tr>
    <tr>
      <td>之后的500万次</td>
      <td>CNY 0.0005</td>
      <td>CNY 0.0005</td>
    </tr>
    <tr>
      <td>之后的4000万次</td>
      <td>CNY 0.00025</td>
      <td>CNY 0.0003</td>
    </tr>
    <tr>
      <td>之后的5000万次</td>
      <td>CNY 0.00018</td>
      <td>CNY 0.0002</td>
    </tr>
    <tr>
      <td>超过1亿次</td>
      <td>CNY 0.0001</td>
      <td>CNY 0.0002</td>
    </tr>
  </tbody>
</table>

<p>天气服务（扩展）</p>

<table>
  <thead>
    <tr>
      <th>请求量</th>
      <th>新价格(每次请求)</th>
      <th>原价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-30万次</td>
      <td>CNY 0.002</td>
      <td>CNY 0.002</td>
    </tr>
    <tr>
      <td>之后的70万次</td>
      <td>CNY 0.0017</td>
      <td>CNY 0.0018</td>
    </tr>
    <tr>
      <td>之后的400万次</td>
      <td>CNY 0.0014</td>
      <td>CNY 0.0014</td>
    </tr>
    <tr>
      <td>之后的500万次</td>
      <td>CNY 0.001</td>
      <td>CNY 0.001</td>
    </tr>
    <tr>
      <td>之后的4000万次</td>
      <td>CNY 0.0006</td>
      <td>CNY 0.0007</td>
    </tr>
    <tr>
      <td>之后的5000万次</td>
      <td>CNY 0.0004</td>
      <td>CNY 0.0005</td>
    </tr>
    <tr>
      <td>超过1亿次</td>
      <td>CNY 0.0003</td>
      <td>CNY 0.0005</td>
    </tr>
  </tbody>
</table>

<p>空气质量</p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
      <th>原价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0-30万次</td>
      <td>CNY 0.001</td>
      <td>CNY 0.001</td>
    </tr>
    <tr>
      <td>之后的70万次</td>
      <td>CNY 0.00088</td>
      <td>CNY 0.0009</td>
    </tr>
    <tr>
      <td>之后的400万次</td>
      <td>CNY 0.0007</td>
      <td>CNY 0.0007</td>
    </tr>
    <tr>
      <td>之后的500万次</td>
      <td>CNY 0.0005</td>
      <td>CNY 0.0005</td>
    </tr>
    <tr>
      <td>之后的4000万次</td>
      <td>CNY 0.00025</td>
      <td>CNY 0.0003</td>
    </tr>
    <tr>
      <td>之后的5000万次</td>
      <td>CNY 0.00018</td>
      <td>CNY 0.0002</td>
    </tr>
    <tr>
      <td>超过1亿次</td>
      <td>CNY 0.0001</td>
      <td>CNY 0.0002</td>
    </tr>
  </tbody>
</table>

<p>太阳辐照</p>

<table>
  <thead>
    <tr>
      <th>请求量(每月)</th>
      <th>新价格(每次请求)</th>
      <th>原价格(每次请求)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>任意次数</td>
      <td>CNY 0.4</td>
      <td>CNY 0.45</td>
    </tr>
  </tbody>
</table>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[从2024年11月1日起，和风天气开发服务的价格将进行如下调整，降低了部分单价并对于大量请求的用户增加了新的阶梯价格。 天气服务 请求量(每月) 新价格(每次请求) 原价格(每次请求) 0-30万次 CNY 0.001 CNY 0.001 之后的70万次 CNY 0.00088 CNY 0.0009 之后的400万次 CNY 0.0007 CNY 0.0007 之后的500万次 CNY 0.0005 CNY 0.0005 之后的4000万次 CNY 0.00025 CNY 0.0003 之后的5000万次 CNY 0.00018 CNY 0.0002 超过1亿次 CNY 0.0001 CNY 0.0002 天气服务（扩展） 请求量 新价格(每次请求) 原价格(每次请求) 0-30万次 CNY 0.002 CNY 0.002 之后的70万次 CNY 0.0017 CNY 0.0018 之后的400万次 CNY 0.0014 CNY 0.0014 之后的500万次 CNY 0.001 CNY 0.001 之后的4000万次 CNY 0.0006 CNY 0.0007 之后的5000万次 CNY 0.0004 CNY 0.0005 超过1亿次 CNY 0.0003 CNY 0.0005 空气质量 请求量(每月) 新价格(每次请求) 原价格(每次请求) 0-30万次 CNY 0.001 CNY 0.001 之后的70万次 CNY 0.00088 CNY 0.0009 之后的400万次 CNY 0.0007 CNY 0.0007 之后的500万次 CNY 0.0005 CNY 0.0005 之后的4000万次 CNY 0.00025 CNY 0.0003 之后的5000万次 CNY 0.00018 CNY 0.0002 超过1亿次 CNY 0.0001 CNY 0.0002 太阳辐照 请求量(每月) 新价格(每次请求) 原价格(每次请求) 任意次数 CNY 0.4 CNY 0.45]]></summary></entry><entry xml:lang="zh"><title type="html">空气质量API v1.3发布</title><link href="https://blog.qweather.com/announce/aqi-v1-3-released/" rel="alternate" type="text/html" title="空气质量API v1.3发布" /><published>2024-09-01T00:00:00+08:00</published><updated>2024-09-01T00:00:00+08:00</updated><id>https://blog.qweather.com/announce/aqi-v1.3-released</id><content type="html" xml:base="https://blog.qweather.com/announce/aqi-v1-3-released/"><![CDATA[<p>全新的空气质量API v1.3现已正式发布，升级内容包括：</p>

<ul>
  <li>空气质量全面提高精度，分辨率为1x1公里</li>
  <li>增加空气质量每日和每小时预报</li>
  <li>增加通用AQI：QAQI</li>
</ul>

<p>请注意：</p>

<ul>
  <li>原空气质量API v1.0 beta版本将在2024年12月31日下线（仅限/airquality/v1/now）</li>
  <li>空气质量API v1将从2024年10月1日起开始正式商用，如果你使用标准订阅或高级订阅，则会开始计费。</li>
</ul>

<p>空气质量API v1.3的开发文档请参考 <a href="https://dev.qweather.com/docs/api/air-quality/">https://dev.qweather.com/docs/api/air-quality/</a></p>]]></content><author><name></name></author><category term="announce" /><summary type="html"><![CDATA[全新的空气质量API v1.3现已正式发布，升级内容包括： 空气质量全面提高精度，分辨率为1x1公里 增加空气质量每日和每小时预报 增加通用AQI：QAQI 请注意： 原空气质量API v1.0 beta版本将在2024年12月31日下线（仅限/airquality/v1/now） 空气质量API v1将从2024年10月1日起开始正式商用，如果你使用标准订阅或高级订阅，则会开始计费。 空气质量API v1.3的开发文档请参考 https://dev.qweather.com/docs/api/air-quality/]]></summary></entry><entry xml:lang="zh"><title type="html">Error Code v2</title><link href="https://blog.qweather.com/post/error-code-v2/" rel="alternate" type="text/html" title="Error Code v2" /><published>2024-08-01T00:00:00+08:00</published><updated>2024-08-01T00:00:00+08:00</updated><id>https://blog.qweather.com/post/error-code-v2</id><content type="html" xml:base="https://blog.qweather.com/post/error-code-v2/"><![CDATA[<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="err">HTTP/</span><span class="mi">2</span><span class="w"> </span><span class="mi">400</span><span class="w">
</span><span class="err">Content-Type:</span><span class="w"> </span><span class="err">application/problem+json</span><span class="w">

</span><span class="p">{</span><span class="w">
  </span><span class="nl">"error"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
    </span><span class="nl">"status"</span><span class="p">:</span><span class="w"> </span><span class="mi">400</span><span class="p">,</span><span class="w">
    </span><span class="nl">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a URL that identifies the error type."</span><span class="p">,</span><span class="w">
    </span><span class="nl">"title"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a short summary of this error."</span><span class="p">,</span><span class="w">
    </span><span class="nl">"detail"</span><span class="p">:</span><span class="w"> </span><span class="s2">"a human-readable explanation for this error."</span><span class="p">,</span><span class="w">
    </span><span class="nl">"invalidParams"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
      </span><span class="p">[</span><span class="w">
        </span><span class="s2">"invalid or missing params"</span><span class="p">,</span><span class="w">
        </span><span class="s2">"only available for 400 errors"</span><span class="w">
      </span><span class="p">]</span><span class="w">
    </span><span class="p">]</span><span class="w">
  </span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>和风天气现已经发布错误码v2版本，新版本将你可能遇到的API错误进行了细分和更加详细的描述，以便开发者可以更容易了解错误的原因，同时也将HTTP Status Code与错误码保持了一致。</p>

<p>我们将从即日起陆续将错误码v2版本迁移至所有API，预计在2025年底前，所有API将应用错误码v2，具体的迁移计划如下：</p>

<ul>
  <li>2024年8月1日之后发布的新版本API将使用错误码v2</li>
  <li>2024年10月1日起，开发者可以提交工单申请主动迁移到错误码v2</li>
  <li>2024年10月20日起，新创建的项目和KEY将使用错误码v2</li>
  <li>2025年底，所有API将应用错误码v2</li>
</ul>

<p>在迁移期间，你会发现不同的项目或API可能返回了不同版本的错误码。</p>

<p>错误码v2的开发文档提供的了新旧版本的详细描述、示例和对比，请参考 <a href="https://dev.qweather.com/docs/resource/error-code/">https://dev.qweather.com/docs/resource/error-code/</a></p>]]></content><author><name></name></author><category term="dev" /><summary type="html"><![CDATA[和风天气现已经发布错误码v2版本，新版本将你可能遇到的API错误进行了细分和更加详细的描述，以便开发者可以更容易了解错误的原因，同时也将HTTP Status Code与错误码保持了一致。]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://dl.qweather.com/sites/blog/upload/error-code-v2.jpg" /><media:content medium="image" url="https://dl.qweather.com/sites/blog/upload/error-code-v2.jpg" xmlns:media="http://search.yahoo.com/mrss/" /></entry></feed>