ICS 07.060 A 47 DB41 河南省地方标准 DB41/T 1809—2019 气象服务数据接口规范 2019 - 03 - 19发布 2019 - 06 - 19实施 河南省市场监督管理局 发布 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由河南省气象标准化技术委员会提出并归口。 本标准起草单位：河南省气象服务中心。 本标准主要起草人：王婉、郭学峰、武鹏、徐鹏、冯杉、杜明哲、刘玉珠、董艳新、俆延锋、张九 营、李宁、徐慈远。 气象服务数据接口规范 1 范围 本标准规定了气象服务数据接口的术语和定义、访问方法、授权机制、效能要求和接口说明。 本标准适用于气象服务数据接口的设计和使用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260—2007 中华人民共和国行政区划代码 3 术语和定义 下列术语和定义适用于本文件。 3.1 气象服务数据 在公众、行业等气象服务中向用户提供的气象数据。 4 访问方法 4.1 访问地址 气象服务数据接口访问地址应采用统一资源定位符（URL）。URL中的服务器地址宜采用域名，不宜 采用IP地址。 4.2 访问步骤 气象服务数据接口按以下步骤访问： a) 用户应通过气象服务数据接口单位提供的气象服务数据系统平台（以下简称“平台”）申请注 册用户名和密码。或应由气象服务数据接口单位给用户在平台上创建用户名和密码； b) 用户应通过用户名和密码登陆平台，申请气象服务数据接口访问账号APPid和气象服务数据接 口访问密钥Key（Key应具有有效期，有效期内用户可重复使用，超过有效期系统为用户重新 生成Key值）； c) 用户应通过用户名和密码登陆平台，获取气象服务数据接口资源访问地址； d) 用户应在气象服务数据资源地址中加入APPid和Key，形式为“&appid=&key=”, 生成服务资源请求地址； e) 用户应采用HTTP协议中的POST方法调用气象服务数据资源请求地址，获取返回结果。 4.3 服务请求 4.3.1 服务请求字符串编码 服务请求字符串编码宜采用UTF-8字符集。 4.3.2 服务请求参数 4.3.2.1 位置参数 位置参数可采用下列五种编码之一： a) 按GB/T 2260—2007规定的中华人民共和国行政区划编码，所有行政区划的位置参数应为12 位，如果是省、市、县、乡镇等不足12位的用数字“0”补全（河南省县级以上行政区划代码 见附录A表A.1）； b) 气象台站区站号（河南省气象台站区站号见附录A表A.2）； c) 气象台站字母代号编码（河南省气象台站字母代号编码见附录A表A.3）； d) 2000国家大地坐标系经纬度信息； e) 其它约定的位置信息。 4.3.2.2 时间参数 时间参数宜采用YYYYMMDDHHmmSS的格式。 其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位），HH表示小时（2位，24小时制）， mm表示分钟（2位），SS表示秒（2位）。 如无特殊说明，时间应为UTC时间。 4.3.3 请求字符串的组成 服务请求字符串应包含服务请求参数、访问密钥等信息，不应包含明文密码等敏感信息。 4.4 服务响应 4.4.1 返回格式 气象服务数据接口宜以JSON格式返回结果（JSON格式示例见附录B）。 返回结果应包括响应代码、响应消息和数据体三部分。其中： a) 响应代码resCode格式宜为整数型（响应代码见附录C）； b) 响应消息resMsg格式宜为字符型，返回内容应为响应代码resCode的详细说明（响应消息见 附录C）； c) 数据体data格式宜为数组型，返回内容应为气象服务数据的具体描述。 4.4.2 返回结果编码 返回结果编码宜采用UTF-8字符集。 5 授权机制 5.1 用户授权要求 气象服务数据接口宜通过加密