| 一、 产品概述 |
| 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 |
