和风天气JWT格式获取数据说明

原创 已于 2025-07-18 11:29:05 修改 · 1.6k 阅读 · 11 ·
CC 4.0 BY-SA版权
本文为Perseverance52博主原创文章，未经博主允许，不得转载！
文章标签：

#风天气JWT格式

于 2025-07-16 11:58:11 首次发布
该文章已生成可运行项目，

和风天气JWT格式获取数据说明

  • 🌿和风天气JWT格式介绍：https://dev.qweather.com/docs/configuration/authentication/#json-web-token
  • ✨👉注意：这里提供的不是最终的方案，只是提供获取的思路。

目前还是可以通过APIKEY方式，获取天气数据,这里仅介绍通过和风天气JWT格式，获取数据实现的方法。

  • ⚡注意：为了提高安全性，SDK 5+将不再支持API KEY。从2027年1月1日起，我们将限制使用API KEY进行身份认证的每日请求数量。

📗针对原使用APIKEY获取基础上进行修改

  • 🌿生成Ed25519密钥
    使用OpenSSL创建Ed25519密钥的方法。
  • 提示：官方建议使用OpenSSL 3.0.1及以上版本创建Ed25519和验证签名。在大多数Linux和macOS的最新版本中已经集成OpenSSl 3.0+，对于Windows，我们推荐使用winget安装OpenSSL。
    提示：你也可以通过在线工具、熟悉的开发语言或第三方库生成Ed25519私钥和公钥。
  • 打开命令提示符终端（CMD），粘贴下列文本生成公钥和私钥:
openssl genpkey -algorithm ED25519 -out ed25519-private.pem && openssl pkey -pubout -in ed25519-private.pem > ed25519-public.pem
  • 在本地，当前文件夹下所生成的密钥：
    在这里插入图片描述
    在这里插入图片描述

在这里插入图片描述

  • 🌿上传公钥
    当你完成密钥对的生成后，你需要将其中的公钥添加到和风天气控制台，用于JWT身份验证。
    可以参考和风说明文档操作：https://dev.qweather.com/docs/configuration/project-and-key/
  • 在项目列表中点击你需要添加凭据的项目:
    在这里插入图片描述
  • 生成JWT

一个完整的JWT包括三个部分：Header，Payload和Signature.

Header
Header包括下列参数并保存为JSON对象格式：

alg 签名算法，请设置为EdDSA
kid 凭据ID(一定要是标注为jwt字样的凭据凭据ID才行，不能使用API KEY的凭据ID)，你可以在控制台-项目管理中查看:(APIKEY 凭据ID不能和JWT凭据ID混用)
在这里插入图片描述

{
    "alg": "EdDSA",
    "kid": "T8GYP76CD2"//JWT凭据ID
}

Payload
Payload包括下列参数并保存为JSON对象格式：

  • sub 签发主体，这个值是凭据的项目ID，项目ID在控制台-项目管理中查看
    在这里插入图片描述

  • iat 签发时间，这个值表示JWT签发生效的时间，UNIX时间戳格式。为了防止时间误差，建议你将iat设置为当前时间之前的30秒，并确保你的服务器或设备的时间和日期是正确的。

  • exp 过期时间，这个值表示JWT在何时过期，UNIX时间戳格式。较长的过期时间可以减轻负载，但是较短的时间可以提高安全性。你应该根据使用场景设置过期时间，例如在服务端，可能适合较长的时间，在前端则适合较短的时间。目前允许的有效期最长为24小时（86400秒）。

{
    "sub": "29KVA6G27T",//项目ID
    "iat": 1703912400,
    "exp": 1703912940
}
  • Signature
    将Header和Payload分别进行Base64URL编码并用英文句号拼接在一起，使用你的私钥(ed25519-private.pem中的密钥字符串)对其进行Ed25519算法的签名，之后对签名结果,同样需要进行Base64URL编码。

注意：必须使用Base64URL编码，而不是Base64，两者有些许差别。

拼接在一起，最后，请将Base64URL编码后的Header、Payload和Signature使用英文句号(.)拼接在一起，组合为最终的Token，即 header.payload.signature，最终看起来像是：

eyJhbGciOiAiRWREU0EiLCJraWQiOiAiQUJDRDEyMzQifQ.eyJpc3MiOiJBQkNEMTIzNCIsImlhdCI6MTcwMzkxMjQwMCwiZXhwIjoxNzAzOTEyOTQwfQ.MEQCIFGLmpmAEwuhB74mR04JWg_odEau6KYHYLRXs8Bp_miIAiBMU5O13vnv9ieEBSK71v4UULMI4K5T9El6bCxBkW4BdA
  • 🔬验证拼接的JWT正确性
  • 🔖在和风个人账户控制台-帮助与支持-JWT验证：

将Header，Payload和Signature三部分拼接成的完整的JWT完整的Token输入验证框中，点击验证。

在这里插入图片描述

  • JWTl解码和编码在线验证: https://jwt.io/
    在这里插入图片描述
  • 其他JWT编码和解码：https://www.json.cn/jwt
  • 🌿发送JWT请求
    将上述创建的完整Token作为参数添加到Authorization: Bearer请求标头，例如：
curl --compressed \
-H 'Authorization: Bearer eyJhbGciOiAiRWREU0EiLCJraWQiOiAiQUJDRDEyMzQifQ.eyJpc3MiOiJBQkNEMTIzNCIsImlhdCI6MTcwMzkxMjQwMCwiZXhwIjoxNzAzOTEyOTQwfQ.MEQCIFGLmpmAEwuhB74mR04JWg_odEau6KYHYLRXs8Bp_miIAiBMU5O13vnv9ieEBSK71v4UULMI4K5T9El6bCxBkW4BdA' \
'https://abcxyz.qweatherapi.com/v7/weather/now?location=101010100'
  • 🔧API 配置
  • 参考官方文档：https://dev.qweather.com/docs/configuration/api-config/

请求URL
通常来讲，一个完整的API请求URL由scheme，host，path，path parameters和query parameters组成：

  • scheme: 仅支持HTTPS协议。
    host: 开发者的API Host，请在控制台-设置中查看。
    在这里插入图片描述

path: API的请求路径（或称之为API端点、Endpoint）。
path params: 路径参数均为必选参数。
query params: 查询参数，包括必选和可选参数，多个查询参数使用&分割。

https://abcxyz.qweatherapi.com/airquality/v1/station/{LocationID}?lang=en
\___/   \____________________/\____________________/\___________/\______/
scheme           host                  path              path      query
                                                        params     params

Python验证程序

import requests
import jwt
import time
#填ed25519-private.pem里的内容
private_key='''-----BEGIN PRIVATE KEY-----
MC4CAQAwBQYDK2VwBCIEIMt6oO4GC+QnzZFEp/Q245fpquD+j5wKApSJaY2MHFuJ
-----END PRIVATE KEY-----'''

headers = {
    "kid": "T8GYP76CD2", #凭据id
     "typ": None  # 显式设置为None来移除typ字段
}
payload={
    "sub": "29KVA6G27T",    #项目id
    'iat': int(time.time()) - 30,
    'exp': int(time.time()) + 86000
}
# pip install cryptography
# encoded_jwt = jwt.encode(payload, private_key, algorithm='EdDSA', headers = headers)
# 直接使用算法名称生成 JWT 令牌
encoded_jwt = jwt.encode(payload, key=private_key, algorithm='EdDSA', headers=headers)

print(f"JWT:  {encoded_jwt}")


#api host headers
api_host = 'https://p578kpmqqn.re.qweatherapi.com'#填写自己的apihost
headers = {'Authorization': f'Bearer {encoded_jwt}'}
city_api = '/geo/v2/city/lookup'  #城市代码查询api
now_api = '/v7/weather/now'#实时天气api

#城市代码查询
# city='北京'#填写城市名查询天气
# params = {'location': city}
# url = f'{api_host}{city_api}'
# response = requests.get(url,headers=headers,params=params)
# city_id = response.json()['location'][0]['id']  # 获取城市代码
# city_name = response.json()['location'][0]['name']  # 获取城市名称
# country = response.json()['location'][0]['country']  # 获取国家名
#实时天气数据获取
city_id='101250301'#填写城市代码查询天气
url= f'{api_host}{now_api}'
headers = {'Authorization': f'Bearer {encoded_jwt}'}
params = {
    'location': city_id,  #城市代码(必须)
    'lang': 'zh',#语言
    'unit': 'm'#数据单位设置，可选值包括unit=m（公制单位，默认）和unit=i（英制单位）
}
response = requests.get(url,headers=headers,params=params)
print(response)
print(response.text)
# now_weather_data = response.json()
print("完整API响应数据:")
print(response.json())  # 直接打印完整的JSON响应
# 打印当前天气数据
# print(f'城市: {country} {city_name}')  # 打印城市名
# print(now_weather_data['now']['text'])  # 打印当前天气状况
# print(f'温度: {now_weather_data["now"]["temp"]}°C')  # 打印当前温度
# print(f'体感温度: {now_weather_data["now"]["feelsLike"]}°C')  # 打印当前体感温度
# print(f'湿度: {now_weather_data["now"]["humidity"]}%')  # 打印当前湿度
# print(f'风向: {now_weather_data["now"]["windDir"]}')  # 打印当前风向
# print(f'风力等级: {now_weather_data["now"]["windScale"]}')  # 打印当前风力等级
# print(f'风速: {now_weather_data["now"]["windSpeed"]} km/h')  # 打印当前风速
# print(f'数据更新时间: {now_weather_data["updateTime"]}')  # 打印数据更新时间

'''
报错NotImplementedError: Algorithm 'EdDSA' could not be found. Do you have cryptography installed?
解决pip install --upgrade cryptography
pip uninstall PyJWT
推荐安装版本：pip install PyJWT[crypto]==2.6.0
'''
  • 运行结果：
 python .\HAPI.py
JWT:  eyJhbGciOiJFZERTQSIsImtpZCI6IlQ4R1lQNzZDRDIifQ.eyJzdWIiOiIyOUtWQTZHMjdUIiwiaWF0IjoxNzUyNzQ0MTkzLCJleHAiOjE3NTI4MzAyMjN9.MHYpyWLN9PN7YnCxCUij1OxpcBL4AqqFwLheGt-X-YZuySUM87Ubz7lqCtJU_xiuUtBzaOkZYjqD1VzayFfRAg
<Response [200]>
{"code":"200","updateTime":"2025-07-17T17:18+08:00","fxLink":"https://www.qweather.com/weather/beijing-101010100.html","now":{"obsTime":"2025-07-17T17:16+08:00","temp":"35","feelsLike":"35","icon":"100","text":"晴","wind360":"0","windDir":"{'code': '200', 'updateTime': '2025-07-17T16:52+08:00', 'fxLink': 'https://www.qweather.com/weather/beijing-101010100.html', 'now': {'obsTime': '2025-07-17T16:48+08:00', 'temp': '35', 'feelsLike': '36', 'icon': '100', 'text': '晴', 'wind360': '45', 'windDir': '东北风', 'windScale': '2', 'windSpeed': '6', 'humidity': '29', 'precip': '0.0', 'pressure': '998', 
'vis': '30', 'cloud': '7', 'dew': '17'}, 'refer': {'sources': ['QWeather'], 'license': ['QWeather Developers License']}}
  • ✨注意：请不要同时使用多种身份认证方式，可能会导致身份认证失败
本文章已经生成可运行项目
和风天气控制台的JWT身份认证（android 代码调用）
mmsx
07-10 123
本文介绍了Android SDK开发中使用JWT认证和SSH密钥配置的简化流程。首先指出JWT认证官方教程看似复杂实则简单。其次详细说明通过git生成Ed25519密钥的方法：使用ssh-keygen命令连按3次回车生成无密码密钥，并获取公钥私钥路径。接着指导将公钥内容复制到服务器端，凭据名称可自定义。最后说明将生成的私钥直接配置到Android项目中即可运行。全文提供了从密钥生成到部署的完整操作指南，简化了开发者的配置流程。
和风天气python下的api
11-06
和风天气的python代码，嘻嘻我们很高兴的与你分享和风天气最新版本的天气数据API服务，目前的版本代号为s6 如果你寻求更早期的版本（x3和v5）文档，可以参考历史版本接口。请注意，当你看到这篇文章的时候，新注册的用户仅能使用s6版本的接口服务。 任何问题，请先查看本接口文档或帮助中心，可以节省更多的时间。 不建议以 IP 进行访问，IP变更导致的后果，自行承担
Java开发实战：使用Hutool与JWT快速接入和风天气API
m0_73944572的博客
07-19 1202
本文旨在帮助开发者使用 Java 技术栈 快速集成 和风天气 API，以获取实时和未来的天气数据。通过详细的步骤指导，从注册账号、创建项目、生成 JWT 认证令牌，到最终调用天气接口并解析返回的 Gzip 压缩 JSON 数据，整个过程清晰明了。
window电脑使用OpenSSL创建Ed25519密钥
weixin_65116989的博客
08-26 558
通过 WinGet 在 Windows 上安装 OpenSSL 的简明教程：首先检查 WinGet 是否可用，然后搜索并安装 OpenSSL 包（推荐 FireDaemon 版本）。安装后验证版本，将 OpenSSL 的 bin 目录添加到系统 PATH 变量。最后演示了使用 OpenSSL 生成 ED25519 密钥对的方法，包括创建私钥和从私钥导出公钥的命令。整个过程简单明了，适合开发者快速配置 OpenSSL 环境。
和风天气 jwt 生成工具类
wonder_dog的博客
07-17 226
算法， 也没找到好用的工具类 deepseek 生成一个工具类 供参考。hutool 不支持。
#python爬取天气数据——和风天气
taozighhg的博客
04-12 4624
@TOC#python爬取天气数据——和风天气 Python爬取和风天气（自学，不足之处大家包涵） 这是博主第一篇博客，也是断断续续自学python以来第一个试验的爬虫项目。之前看过许多项目，一直担心封IP和反爬之类的问题，直到看到和风天气有个免费API，于是决定尝试一下！接下来会分为几个 模块进行。 1、前期准备–注册和风天气，添加应用并拿到免费KEY 注册地址为 *https://dev.he...
一次配网实现和风key和城市id输入（全网唯一）
kim5659的博客
02-07 2290
首先感谢“单片机菜鸟哥”给予的原码思路及帮助。 单片机菜鸟哥微博链接：https://blog.csdn.net/dpjcn1990 自己做天气时钟已经有一段时间了，照着各位大神的教程几下就可以完成一个“作品”。但作完之后总感觉不满意，于是各种改，苦于各方面的知识有限，于是各种恶补。但还是不得要领，很多东西拿现成的是没有的，比如显示农历，配网时输入和风天气key和城市Id。网上的资料多数只是个思路，实现也不太满意。 比如，配网时输入和风天气key和城市id，有人已经做完了，但需要二次输入，就是先配网，
vue3使用和风天气插件
m0_63026408的博客
06-06 915
在一些项目中一般有些需要一些显示天气的预报，特别是在农业类的大屏中，一般需要展示未来几天的天气预报，最好还是自带图标的天气插件，今天就说一下再vue3中使用和风天气插件。比较好用。首先需要注册为开发者，下面是链接。
如何获取和风天气Web API的KEY？（简要步骤）
热门推荐
weixin_62073160的博客
03-14 1万+
1.跳转到。
python和风api获取天气（JSON Web Token）
qq_41490154的博客
05-29 1343
本文介绍了如何使用OpenSSL生成ED25519密钥对并接入和风天气API的完整流程。首先从官网下载安装OpenSSL，配置环境变量后生成私钥和公钥文件。然后在和风控制台创建项目，上传公钥并获取凭据ID、项目ID和API主机地址。接着提供了Python示例代码，展示了如何使用JWT进行认证并调用天气API，包括城市查询和实时天气数据获取功能。最后提醒了可能遇到的加密模块报错解决方案（升级cryptography库）。整个过程涵盖了从密钥生成到API调用的完整开发流程。
和风天气城市代码数据库，和风天气数据接口调用key转让，
ywqb95的博客
08-30 3000
和风天气城市列表更新了，把最新数据保存在数据库中是开发和风天气应用一个好方法。不难。 一个类一个文件。 public class Province extends DataSupport { private int id; private String provinceName; public int getId() { return id;
Web 服务与 API 集成 (Web Services & API Integration)实现天气预报
06-28
该 Python 脚本首先从一个 PEM 格式的私钥文件 (ed25519-private.pem) 中加载 Ed25519 私钥。接着，它利用此私钥和预设的 payload（包含订阅者 ID、签发和过期时间）及 headers（包含密钥 ID），通过 EdDSA 算法生成一个 JWT。生成的 JWT 被用作 HTTP 请求头中的 Bearer Token，向和风天气 API (https://kf59fb8jp2.re.qweatherapi.com/v7/grid-weather/24h) 发送请求，以获取指定经纬度（113.84, 34.54）的 24 小时逐小时天气预报。最后，脚本解析 API 返回的 JSON 数据，并使用一个预定义的 field_map 字典将英文键翻译成中文，同时格式化时间字段，最终以中文友好的 JSON 格式打印出天气预报信息。私钥需要开发者自己生成自己保留。生成文档可以参照和风天气文档
JAVA毕设-基于和风天气API与腾讯位置SDK的Android天气预报APP系统源码+项目说明.7z
12-06
【特别强调】 1、csdn上资源保证是完整最新，会不定期更新优化； 2、请用自己的账号在csdn官网下载，若通过第三方代下，博主不对您下载的资源作任何保证，且不提供任何形式的技术支持和答疑！！！ 运行： 1、先到 和风天气api注册，实名认证获得七天天气预报权限。 2、申请 web api 的key 3、在 tq\app\src\main\java\com\xianguoliang\tools\MyApp.java 文件下的 HEKEY 变量赋值你申请的和风天气接口Key 【项目功能】 1、定位获取当前城市 2、通过网络API 获取天气数据 3、通过网络下载对应的天气背景 4、左右滑动切换城市天气及相应的背景 5、搜索及收藏城市 通过sqlite数据库实现收藏功能 通过网络API搜索城市名 6、查看收藏城市列表 点击列表栏目可以显示对应的城市天气界面 长按栏目可以选择删除收藏城市 【备注】 该项目主要针对计算机相关专业的正在做毕设的学生和需要项目实战的Java学习者。
【API接口实战】QWeather和风天气JWT鉴权Python调用模板（Ed25519私钥）
07-12
它核心演示了如何利用Ed25519私钥进行JWT（JSON Web Token）鉴权，并成功调用和风天气API获取24小时网格天气预报数据。 核心亮点与解决痛点： 先进鉴权机制： 深入实践和风天气推荐的JWT鉴权方式，特别是Ed25519非...
Arduino框架下ESP8266获取和风天气的第三方库实现天气时钟制作思路
perseverance51博客
12-28 4565
Arduino开发平台通过ESP8266获取和风天气的第三方库更容易实现天气时钟制作思路 先贴上引用B站的链接：https://www.bilibili.com/read/cv7333000 ESP8266获取和风天气的第三方库：ESP8266_Heweather 如果制作天气时钟，完全可以把三个示例程序整合到一个程序里面，把自己需要的部分保留下来，使用此库可以省去繁杂的HTTPS请求以及JSON解析部分，使用几行代码即可获取有效信息，大大简化了开发步骤。 https://github.com/Ldufan
和风天气生成jwt令牌
02-20
### 和风天气API中的JWT令牌生成 在和风天气的服务中，为了实现安全的身份验证机制，采用JSON Web Token (JWT)[^1]作为访问凭证。对于开发者而言，在调用和风天气API之前，需先通过合法途径获得此令牌。 通常情况...
和风天气api使用jwt方法
04-03
为了实现通过 JSON Web Token (JWT) 方式调用和风天气 API 的需求，以下是详细的说明： #### 1. 和风天气 API 支持的认证方式 和风天气官方支持多种认证机制来访问其 API 数据。通常情况下，默认使用的是基于 `key`...
微信小程序JWT访问和风天气验证
最新发布
09-05
提供的引用内容未涉及微信小程序使用JWT访问和风天气的验证方法相关信息。不过，一般而言，微信小程序使用JWT访问和风天气的验证方法可按以下思路进行： ### 1. 获取JWT令牌 在和风天气的开发者平台进行注册并创建...
和风天气接口
xiaodaidaiPromax_2024
06-13 2374
和风天气接口
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值