接口鉴权方式
当你在控制台 中添加了 API 产品后,即可在产品详情中查看该 API 产品的密钥。
每组密钥由APPid和APPSecret:组成,例如:
- APPid:201219612
- APPSecret: SMEieQjde1C9eXnbE
智云天气支持两种 API 安全验证方式:
1. “私钥” APPSecret直接请求方式
将 API 密钥中的“私钥”作为 API 请求中的 key 参数值:https://zhy.sailxy.com/Getdata?key=你的APPSecret &city=北京&type=today&sign=v1
参数 | 值 | 说明 | 是否必填 |
---|---|---|---|
key | SMEieQjde1C9eXnbE | 你的APPSecret值 | 是 |
sign | v1 | 接口请求方式,v1直接请求,v2签名方式请求 | 是 |
type | today | 请求数据的种类,后续具体接口中会有说明 | 是 |
city | 北京 | 不带“市”、“县”等字样,请求天气的城市 | 否 |
值得注意的是:此方式较为方便,但请注意不要泄漏你的“私钥”。
2. “公钥 + 私钥” 签名验证方式
“公钥 + 私钥” 验证方式更加安全。请求地址中只包含你的“公钥”以及用你的“私钥”制作的签名,因此不会在请求地址中泄露你的私钥。具体使用方式请如下
参数值:https://zhy.sailxy.com/Getdata?key=制作的签名&city=北京&type=today&sign=v2&appid=201219612&unix=1630762031
key 值制作说明:你的私钥APPSecret即 SMEieQjde1C9eXnbE加上当前时间戳1630762031取MD5的值 即对 SMEieQjde1C9eXnbE1630762031 取md5 :8b38cc0c26dbcc24a3f2341e6fff96ff
js 获取时间戳:var unix = Date.parse(new Date())/1000;
前端js取Md5的js下载 使用其中的hex_md5函数即可
参数 | 值 | 说明 | 是否必填 |
---|---|---|---|
key | SMEieQjde1C9eXnbE | 你的APPSecret值 | 是 |
sign | v2 | 接口请求方式,v1直接请求,v2签名方式请求 | 是 |
unix | 1630762031 | 当前时间戳 | 是 |
appid | 201219612 | 你的appid,可在控制台查看 | 是 |
type | today | 请求数据的种类,后续具体接口中会有说明 | 是 |
city | 北京 | 不带“市”、“县”等字样,请求天气的城市 | 否 |