中国气象局开 放平台接口使用说明书.pdfVIP

SmartWeatherAPI Lite Open 版接口使用说明书 中国气象局公共气象服务中心 2014/11/20 版本号：3.0.3 SmartWeatherAPI Open 版接口使用说明书 Lite 目录 一、 产品概述 2 二、 使用说明 2 三、 调用规范 2 四、 服务内容 3 4.1 常规预报 3 4.2 指数 6 五、 编码表 7 5.1 天气现象编码表 7 5.2 风力风向编码表 8 六、 数据更新频率表 8 1 SmartWeatherAPI Open 版接口使用说明书 Lite 一、 产品概述 SmartWeatherAPI 接口(简称”SWA”接口)是中国气象局面向 网络媒体、手机厂商、第三方气象服务机构等用户，通过web 方 式提供数据气象服务的官方载体。 二、 使用说明 该数据主要包括3 天常规预报(24小时)、指数数据内容。 三、 调用规范 规范用于指导三方合作伙伴合理调用3 天常规预报(24小 时)、指数服务数据。 请求方式：http get 接口组成：由固定URL 加5 个不同的参数组成，完整URL 需客户 端经过固定方式加密后使用。 数据返回：json 完整URL ： /data/?areaid=type=date= appid=key=.urlencode($key); 固定URL ：/data/ 输入参数： 参数名称 参数含义 参数样例 areaid 区域id 单区域:101010100 多区域:101010100|101010200 type 数据类型 指数:index_f(基础)、index_v(常规) 3 天常规预报(24 小时):forecast_f(基础) 、 forecast_v (常规) date 客户端日期 按照格式yyyyMMddHHmm 获取客户端当前时间 appid 固定分配的型 xx: 1234567890 2 SmartWeatherAPI Open 版接口使用说明书 Lite 号标识 传递参数时:截取appid 的前6 位 生成公钥时:取完整的appid key 令牌 由公钥(public_key)和私钥(private_key)通过 固定算法加密生成 加密方式:  private_key xx:123456_SmartWeatherAPI_789 private_key 仅负责与public_key 共同合成key 传参，私钥 不可见，客户端与服务端各存储一份;  public_key 为不包含 key 在内的完整 URL 其它部分（此处 appid 为完整appid） 示例: /data/?areaid=101010200ty pe=forecast_fdate=201211281030appid=123456