ICS 07.060 A 47 DB41 河 南 省 地 方 标 准 DB41/T 1809—2019 气象服务数据接口规范 2019 - 03 - 19 发布 河南省市场监督管理局 2019 - 06 - 19 实施 发 布 DB41/T 1809—2019 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由河南省气象标准化技术委员会提出并归口。 本标准起草单位：河南省气象服务中心。 本标准主要起草人：王婉、郭学峰、武鹏、徐鹏、冯杉、杜明哲、刘玉珠、董艳新、俆延锋、张九 营、李宁、徐慈远。 I DB41/T 1809—2019 气象服务数据接口规范 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=<APPid>&key=<Key>”, 生成服务资源请求地址； e) 用户应采用 HTTP 协议中的 POST 方法调用气象服务数据资源请求地址，获取返回结果。 4.3 服务请求 1 DB41/T 1809—2019 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 用户授权要求 气象服务数据接口宜通过加密算法对用户进行授权。 5.2 用户授权算法 2 DB41/T 1809—2019 宜将接口请求参数按照顺序拼接成字符串，加上时间戳（格式为YYYYMMDD）形成新的字符串，对新 字符串做MD5消息摘要算法的32位加密，形成Key值。 其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位）。 6 效能要求 6.1 并行性 气象服务数据接口应提供多用户并行访问支持。 6.2 响应时间 气象服务数据接口响应时间应小于500 ms。 7 接口说明 气象服务数据接口单位应提供接口说明，并应与气象服务数据接口一起提交用户使用。 接口说明应包括气象服务数据接口描述、调用请求方式、参数说明、常用参数代码等内容，并给出 数据接口调用示例代码（数据接口说明示例见附录D）。 3 DB41/T 1809—2019 AA 附 录 A （资料性附录） 位置参数编码 A.1 河南省县以上行政区划代码 见表A.1。 表A.1 河南省县以上行政区划代码 4 单位名称 行政区划 单位名称 行政区划 单位名称 行政区划 河南省 410000000000 内黄县 410527000000 南阳市 411300000000 郑州市 410100000000 林州市 410581000000 宛城区 411302000000 中原区 410102000000 鹤壁市 410600000000 卧龙区 411303000000 二七区 410103000000 鹤山区 410602000000 南召县 411321000000 管城回族区 410104000000 山城区 410603000000 方城县 411322000000 金水区 410105000000 淇滨区 410611000000 西峡县 411323000000 上街区 410106000000 浚县 410621000000 镇平县 411324000000 惠济区 410108000000 淇县 410622000000 内乡县 411325000000 中牟县 410122000000 新乡市 410700000000 淅川县 411326000000 巩义市 410181000000 红旗区 410702000000 社旗县 411327000000 荥阳市 410182000000 卫滨区 410703000000 唐河县 411328000000 新密市 410183000000 凤泉区 410704000000 新野县 411329000000 新郑市 410184000000 牧野区 410711000000 桐柏县 411330000000 登封市 410185000000 新乡县 410721000000 邓州市 411381000000 开封市 410200000000 获嘉县 410724000000 商丘市 411400000000 龙亭区 410202000000 原阳县 410725000000 梁园区 411402000000 顺河回族区 410203000000 延津县 410726000000 睢阳区 411403000000 鼓楼区 410204000000 封丘县 410727000000 民权县 411421000000 禹王台区 410205000000 长垣县 410728000000 睢县 411422000000 祥符区 410212000000 卫辉市 410781000000 宁陵县 411423000000 杞县 410221000000 辉县市 410782000000 柘城县 411424000000 通许县 410222000000 焦作市 410800000000 虞城县 411425000000 尉氏县 410223000000 解放区 410802000000 夏邑县 411426000000 兰考县 410225000000 中站区 410803000000 永城市 411481000000 洛阳市 410300000000 马村区 410804000000 信阳市 411500000000 老城区 410302000000 山阳区 410811000000 浉河区 411502000000 西工区 410303000000 修武县 410821000000 平桥区 411503000000 DB41/T 1809—2019 表A.1 河南省县以上行政区划代码（续） 单位名称 行政区划 单位名称 行政区划 单位名称 行政区划 瀍河回族区 410304000000 博爱县 410822000000 罗山县 411521000000 涧西区 410305000000 武陟县 410823000000 光山县 411522000000 吉利区 410306000000 温县 410825000000 新县 411523000000 洛龙区 410311000000 沁阳市 410882000000 商城县 411524000000 孟津县 410322000000 孟州市 410883000000 固始县 411525000000 新安县 410323000000 濮阳市 410900000000 潢川县 411526000000 栾川县 410324000000 华龙区 410902000000 淮滨县 411527000000 嵩县 410325000000 清丰县 410922000000 息县 411528000000 汝阳县 410326000000 南乐县 410923000000 周口市 411600000000 宜阳县 410327000000 范县 410926000000 川汇区 411602000000 洛宁县 410328000000 台前县 410927000000