和风天气接口

和风天气接口

目录

 和风天气接口

n 一、登陆注册创建项目

n 二、官方文档

n API 配置

n 创建项目和KEY

n 了解API地址和参数

n Gzip

n 尝试一下

一、登陆注册创建项目

网址：控制台 | 和风天气

拿到了：key

0427a840c2c342e7a6f509f245c3327c

请求网址：

https://api.qweather.com/v7/weather/now?location=长春&key=0427a840c2c342e7a6f509f245c3327c

https://api.qweather.com/v7/weather/now?location=101010100&key=0427a840c2c342e7a6f509f245c3327c

二、官方文档

API 配置

在开始使用和风天气API服务之前，你需要进行一些简单的配置和准备工作。

创建项目和KEY

请确保已经创建了项目和Web API KEY，否则请参考项目和KEY。

了解API地址和参数

通常来讲，一个完整的API请求URL由scheme，host，port，path和query parameters组成。（当然，在不同程序中可能叫法不一样，我们仅以RFC 3986为参考）

https://api.qweather.com/v7/weather/now?location=xxx&key=xxx
\___/   \______________/\______________/\__________________/
scheme        host   (port)   path        query parameters 

• scheme: https

• host: api.qweather.com

• port: 443 （在和风天气开发服务中，所有端口均为443）

• path: /v7/weather/7d?

• query parameters: location=xxx&key=xxx （在和风天气开发服务中，多个参数使用&分割）

对于不同的订阅和数据，API host会有所不同，请以开发文档中的说明为准。

注意：如果你使用的是免费订阅，必须使用免费订阅的API host: devapi.qweather.com。但地理信息服务除外，无论免费订阅还是付费订阅，都使用geoapi.qweather.com。

对于大部分开发者来说，构建一个API URL并非难事，但我们仍然强烈建议你阅读最佳实践-优化请求文档，了解发送API请求的一些常见问题和经验。

Gzip

请注意，和风天气开发服务的API均使用Gzip进行了压缩，这将极大的减少网络流量，加快请求。因此，当你在开发过程中，需要对返回的数据进行解压。请参考最佳实践-Gzip。

尝试一下

请复制并粘贴下列链接到你的浏览器中，看看返回了哪些内容。注意链接最后的参数key要换成你自己的KEY。

• 如果你使用的是标准订阅，请复制下列链接：

  https://api.qweather.com/v7/weather/3d?location=101010100&key=这里替换成你的key

• 如果你使用的是免费订阅，请复制下列链接：

  https://devapi.qweather.com/v7/weather/3d?location=101010100&key=这里替换成你的key

如果一切正常，我们打开终端再试一下，请复制并粘贴下列命令到你的终端中。注意代码最后的参数key要换成你自己的KEY。

• 如果你使用的是标准订阅，请复制下列代码：

  curl -L -X GET --compressed 'https://api.qweather.com/v7/weather/3d?location=101010100&key=这里替换成你的key'

• 如果你使用的是免费订阅，请复制下列代码：

  curl -L -X GET --compressed 'https://devapi.qweather.com/v7/weather/3d?location=101010100&key=这里替换成你的key'

好了，到此为止，API的配置和调试基本完成了，下一步请参考开发文档，实用资料和最佳实践开始你的开发之旅吧！