DB41∕T 1809-2019 气象服务数据接口规范

《DB41∕T 1809-2019 气象服务数据接口规范》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、ICS07.060A47DB41河南省地方标准DB41/T1809—2019气象服务数据接口规范2019-03-19发布2019-06-19实施河南省地方标准公共服务平台河南省市场监督管理局发布DB41/T1809—2019前言本标准按照GB/T1.1—2009给出的规则起草。本标准由河南省气象标准化技术委员会提出并归口。本标准起草单位：河南省气象服务中心。本标准主要起草人：王婉、郭学峰、武鹏、徐鹏、冯杉、杜明哲、刘玉珠、董艳新、俆延锋、张九营、李宁、徐慈远。河南省地方标准公共服务平台IDB41/T1809—2019气象服务数据接口规范1范围本标准规定了气

2、象服务数据接口的术语和定义、访问方法、授权机制、效能要求和接口说明。本标准适用于气象服务数据接口的设计和使用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260—2007中华人民共和国行政区划代码3术语和定义下列术语和定义适用于本文件。3.1气象服务数据在公众、行业等气象服务中向用户提供的气象数据。4访问方法4.1访问地址气象服务数据接口访问地址应采用统一资源定位符（URL）。URL中的服务器地址宜采用域名，不宜采用IP

3、地址。4.2访问步骤气象服务数据接口按以下步骤访问：a)用户应通过气象服务数据接口单位提供的气象服务数据系统平台（以下简称“平台”）申请注册用户名和密码。或应由气象服务数据接口单位给用户在平台上创建用户名和密码；b)用户应通过用户名和密码登陆平台，申请气象服务数据接口访问账号APPid和气象服务数据接口访问密钥Key（Key应具有有效期，有效期内用户可重复使用，超过有效期系统为用户重新生成Key值）；c)用户应通过用户名和密码登陆平台，获取气象服务数据接口资源访问地址；d)用户应在气象服务数据资源地址中加入APPid和Key，形式为“&appid=

4、id>&key=”,生成服务资源请求地址；e)用户应采用HTTP协议中的POST方法调用气象服务数据资源请求地址，获取返回结果。4.3服务请求河南省地方标准公共服务平台1DB41/T1809—20194.3.1服务请求字符串编码服务请求字符串编码宜采用UTF-8字符集。4.3.2服务请求参数4.3.2.1位置参数位置参数可采用下列五种编码之一：a)按GB/T2260—2007规定的中华人民共和国行政区划编码，所有行政区划的位置参数应为12位，如果是省、市、县、乡镇等不足12位的用数字“0”补全（河南省县级以上行政区划代码见附录A表A.1）；b)气

5、象台站区站号（河南省气象台站区站号见附录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.

6、4.1返回格式气象服务数据接口宜以JSON格式返回结果（JSON格式示例见附录B）。返回结果应包括响应代码、响应消息和数据体三部分。其中：a)响应代码resCode格式宜为整数型（响应代码见附录C）；b)响应消息resMsg格式宜为字符型，返回内容应为响应代码resCode的详细说明（响应消息见附录C）；c)数据体data格式宜为数组型，返回内容应为气象服务数据的具体描述。4.4.2返回结果编码返回结果编码宜采用UTF-8字符集。5授权机制5.1用户授权要求气象服务数据接口宜通过加密算法对用户进行授权。5.2用户授权算法河南省地方标准公共服务平台2DB41

7、/T1809—2019宜将接口请求参数按照顺序拼接成字符串，加上时间戳（格式为YYYYMMDD）形成新的字符串，对新字符串做MD5消息摘要算法的32位加密，形成Key值。其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位）。6效能要求6.1并行性气象服务数据接口应提供多用户并行访问支持。6.2响应时间气象服务数据接口响应时间应小于500ms。7接口说明气象服务数据接口单位应提供接口说明，并应与气象服务数据接口一起提交用户使用。接口说明应包括气象服务数据接口描述、调用请求方式、参数说明、常用参数代码等内容，并给出数据接口调用示例代码（数据接口

8、说明示例见附录D）。河南省地方标准公共服务平台3DB41/T180