如何获取心知天气API密钥(分步指南)

在气候变化与日常出行日益紧密关联的今天，获取准确的天气信息对于个人出行规划、企业运营决策乃至农业种植等众多领域都显得尤为关键。心知天气API正是为满足这一广泛需求而设计的，它提供了详尽且实时的天气数据服务，使开发者能够将高质量的天气信息集成到各种应用中，无论是旅行规划、运动追踪还是智能家居系统，都能为用户带来极大的便利。本文将逐步指导你如何获取心知天气API的密钥，通过简便的注册与申请步骤，你将能够轻松掌握这一强大的天气数据获取工具。

1. 添加产品

去心知天气平台申请一个账号，普通邮箱注册即可

当你添加了 API 产品后，即可在控制台 – 产品管理中点击某个产品，查看该 API 产品的密钥。

2. API请求方式

每组密钥由“公钥”（参数uid）和“私钥”（参数key）组成，例如：

公钥 PKwiV7auWJE3iBJ8d
私钥 SMEieQjde1C9eXnbE

心知天气支持两种 API 安全验证方式：

1. “私钥” 直接请求方式（更简单）

将 API 密钥中的“私钥”作为 API 请求中的 key 参数值：

curl https://api.seniverse.com/v3/weather/now.json?key=your_private_key&location=beijing&language=zh-Hans&unit=c



将your_private_key更改为私钥即可

说明：此方式较为方便，但请注意不要泄漏你的“私钥”。

2. “公钥 + 私钥” 签名验证方式（更安全）

“公钥 + 私钥” 验证方式更加安全。请求地址中只包含你的“公钥”以及用你的“私钥”制作的签名，因此不会在请求地址中泄露你的私钥。

3. 接口说明

接口地址

curl https://api.seniverse.com/v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c

将your_private_key更改为私钥即可

请求参数说明

参数名称	类型	默认值	必填	备注
key	String	无	是	你的 API 密钥
location	Location	无	是	所查询的位置
language	Language	zh-Hans	否	语言
unit	Unit	c	否	单位

4. 返回数据

{

  "results": [

    {

      "location": {

        "id": "C23NB62W20TF",

        "name": "西雅图",

        "country": "US",

        "path": "西雅图,华盛顿州,美国",

        "timezone": "America/Los_Angeles",

        "timezone_offset": "-07:00"

      },

      "now": {

        "text": "多云", //天气现象文字

        "code": "4", //天气现象代码

        "temperature": "14", //温度，单位为c摄氏度或f华氏度

        "feels_like": "14", //体感温度，单位为c摄氏度或f华氏度，暂不支持国外城市。

        "pressure": "1018", //气压，单位为mb百帕或in英寸

        "humidity": "76", //相对湿度，0~100，单位为百分比

        "visibility": "16.09", //能见度，单位为km公里或mi英里

        "wind_direction": "西北", //风向文字

        "wind_direction_degree": "340", //风向角度，范围0~360，0为正北，90为正东，180为正南，270为正西

        "wind_speed": "8.05", //风速，单位为km/h公里每小时或mph英里每小时

        "wind_scale": "2", //风力等级，请参考：http://baike.baidu.com/view/465076.htm

        "clouds": "90", //云量，单位%，范围0~100，天空被云覆盖的百分比 #目前不支持中国城市#

        "dew_point": "-12" //露点温度，请参考：http://baike.baidu.com/view/118348.htm #目前数据缺失中#

      },

      "last_update": "2015-09-25T22:45:00-07:00" //数据更新时间（该城市的本地时间）

    }

  ]

}