一、 产品概述 |
SmartWeatherAPI 接口(简称”SWA”接口)是中国气象局面向 |
网络媒体、手机厂商、第三方气象服务机构等用户,通过 web 方 |
式提供数据气象服务的官方载体。 |
二、 使用说明 |
该数据主要包括预警、实况、指数、常规预报(24 小时)等数 |
据内容。 |
三、 调用规范 |
规范用于指导三方合作伙伴合理调用预警、实况、指数、 |
常规预报(24 小时)等服务数据。 |
请求方式:http get |
接口组成:由固定 URL 加 5 个不同的参数组成,完整 URL 需客户 |
端经过固定方式加密后使用。 |
数据返回:json |
完整 URL: |
http://open.weather.com.cn/data/?areaid=""&type=""&date= |
""&appid=""&key=".urlencode($key); |
固定 URL:http://open.weather.com.cn/data/ |
输入参数: |
加密方式: |
Ø private_key |
示例:见 private_key.txt 附件 |
private_key 仅负责与 public_key 共同合成 key 传参,私钥 |
不可见,客户端与服务端各存储一份; |
Ø public_key 为不包含 key 在内的完整 URL 其它部分(此处 |
appid 为完整 appid) |
示例: |
http://open.weather.com.cn/data/?areaid=101010100&ty |
pe=forecast&date=201211281030&appid=cf2d61521456sads |
Ø key 的算法 |
key=base64_encode(hash_hmac('sha1',$public_key,$priva |
te_key,TRUE)); |
key 加密后通过 urlencode 对其编码后传参 |
注:每一个产品使用用户分配一个唯一标识 appid,用于统计 |
用户访问情况、区分用户提供差异服务,终端用户按照终端型号 |
四、 服务内容 |
4.1 实况 |
接口描述:返回当前实况信息,每个字段都放有当前的数据。(如 |
果没有数据用 ? 表示) |
接口请求方式:http get |
接口返回类型:json |
输入示例: |
http://open.weather.com.cn/data/?areaid=101010100&type |
=observe&date=201212031008&appid=cf2d61&key=w%2B1%2Bfv |
ngN50nJJh6xdu6Mfu7jxg%3D |
4.2 常规预报 |
接口描述: 返回 1 天 24 小时常规预报数据 |
接口请求方式:http get |
接口返回类型:json |
输入示例: |
http://open.weather.com.cn/data/?areaid=101010100&type |
=forecast1d&date=201212010741&appid=cf2d61&key=hPZf1%2 |
F5Ag%2F4JS2A%2BcYmpj5Yv2YA%3D |