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

ICS07.060

A47

DB41

河南省地方标准

DB41/T1809—2019

气象服务数据接口规范

2019-03-19发布2019-06-19实施

河南省市场监督管理局发布

DB41/T1809—2019

前言

本标准按照GB/T1.1—2009给出的规则起草。

本标准由河南省气象标准化技术委员会提出并归口。

本标准起草单位：河南省气象服务中心。

本标准主要起草人：王婉、郭学峰、武鹏、徐鹏、冯杉、杜明哲、刘玉珠、董艳新、俆延锋、张九

营、李宁、徐慈远。

I

DB41/T1809—2019

气象服务数据接口规范

1范围

本标准规定了气象服务数据接口的术语和定义、访问方法、授权机制、效能要求和接口说明。

本标准适用于气象服务数据接口的设计和使用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T2260—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/T1809—2019

4.3.1服务请求字符串编码

服务请求字符串编码宜采用UTF-8字符集。

4.3.2服务请求参数

位置参数

位置参数可采用下列五种编码之一：

a)按GB/T2260—2007规定的中华人民共和国行政区划编码，所有行政区划的位置参数应为12

位，如果是省、市、县、乡镇等不足12位的用数字“0”补全（河南省县级以上行政区划代码

见附录A表A.1）；

b)气象台站区站号（河南省气象台站区站号见附录A表A.2）；

c)气象台站字母代号编码（河南省气象台站字母代号编码见附录A表A.3）；

d)2000国家大地坐标系经纬度信息；

e)其它约定的位置信息。

时间参数

时间参数宜采用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/T1809—2019

宜将接口请求参数按照顺序拼接成字符串，加上时间戳（格式为YYYYMMDD）形成新的字符串，对新

字符串做MD5消息摘要算法的32位加密，形成Key值。

其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位）。

6效能要求

6.1并行性

气象服务数据接口应提供多用户并行访问支持。

6.2响应时间

气象服务数据接口响应时间应小于500ms。

7接口说明

气象服务数据接口单位应提供接口说明，并应与气象服务数据接口一起提交用户使用。

接口说明应包括气象服务数据接口描述、调用请求方式、参数说明、常用参数代码等内容，并给出

数据接口调用示例代码（数据接口说明示例见附录D）。

3

DB41/T1809—2019

AA

附录A

（资料性附录）

位置参数编码

A.1河南省县以上行政区划代码

见表A.1。

表A.1河南省县以上行政区划代码

单位名称行政区划单位名称行政区划单位名称行政区划

河南省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

4

DB41/T1809—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扶沟县411621000000

伊川县410329000000濮阳县410928000000西华县411622000000

偃师市410381000000许昌市411000000000商水县411623000000

平顶山市410400000000魏都区411002000000沈丘县411624000000

新华区410402000000建安区411003000000郸城县411625000000

卫东区410403000000鄢陵县411024000000淮阳县411626000000

石龙区410404000000襄城县411025000000太康县411627000000

湛河区410411000000禹州市411081000000鹿邑县411628000000

宝丰县410421000000长葛市411082000000项城市411681000000

叶县410422000000漯河市411100000000驻马店市411700000000

鲁山县410423000000源汇区411102000000驿城区411702000000

郏县410425000000郾城区411103000000西平县411721000000

舞钢市410481000000召陵区411104000000上蔡县411722000000

汝州市410482000000舞阳县411121000000平舆县411723000000

安阳市410500000000临颍县411122000000正阳县411724000000

文峰区410502000000三门峡市411200000000确山县411725000000

北关区410503000000湖滨区411202000000泌阳县411726000000

殷都区410505000000陕州区411203000000汝南县411727000000

龙安区410506000000渑池县411221000000遂平县411728000000

安阳县410522000000卢氏县411224000000新蔡县411729000000

汤阴县410523000000义马市411281000000济源市419001000000

滑县410526000000灵宝市411282000000--

A.2河南省气象台站区站号

见表A.2。

5

DB41/T1809—2019

表A.2河南省气象台站区站号

单位名称区站号单位名称区站号单位名称区站号单位名称区站号

林县53889洛宁57066嵩县57162邓州57274

安阳53898卢氏57067内乡57169泌阳57281

沁阳53972新安57070平顶山57171桐柏57285

淇县53974孟津57071鲁山57173信阳农试站57289

济源53978孟县57072镇平57175驻马店57290

博爱53979洛阳57073南召57176平玉57292

焦作53982伊川57074舞钢工区57177新蔡57293

封丘53983汝州57075南阳57178确山57294

修武53984偃师57076方城57179正阳57295

辉县53985栾川57077郏县57180息县57296

新乡53986汝阳57078宝丰57181信阳57297

武陡53987温县57079襄城57182罗山57298

获加53988巩县57080临颍57183光山57299

原阳53989荥阳57081叶县57184鸡公山57390

鹤壁53990登封57082舞阳57185新县57396

汤阴53991郑州57083漯河57186睢县58001

浚县53992密县57085社旗57187民权58004

内黄53993新郑57086西平57188商丘58005

卫辉53994长葛57087遂平57189虞城58006

滑县53995禹州57088黄泛区57190柘城58007

延津53997许昌57089通许57191宁陵58008

长恒53998中牟57090淮阳57192商丘县58009

台前54817开封57091西华57193夏邑58010

濮阳54900兰考57093上蔡57194郸城58100

南乐54901尉氏57094周口57195鹿邑58101

清丰54902鄢陵57095项城57196沈丘58104

范县54903杞县57096汝南57197永城58111

三门峡57051郑州农试站57097商水57198淮滨58205

灵宝57056扶沟57098淅川57261潢川58207

渑池57063太康57099新野57271固始58208

宜阳57065西峡57156唐河57273商城58301

A.3河南省气象台站字母编号代码

见表A.3。

6

DB41/T1809—2019

表A.3河南省气象台站字母编号代码

单位名称字母编码单位名称字母编码单位名称字母编码单位名称字母编码

安阳市BFAY灵宝BULB柘城BUZC内乡BUNX

安阳县BTAY洛阳市BFLB宁陵BUNI淅川BUXI

汤阴BUTY孟津BTMJ夏邑BUXY西峡BTXA

内黄BUNH汝阳BURY永城BUYO南召BUNZ

滑县BUHX伊川BUYC平顶山BFPS桐柏BUTB

林州BULZ嵩县BUSX汝州BURZ驻马店市BFZM

鹤壁市BFHI栾川BTLC鲁山BULS遂平BUSP

浚县BUXU宜阳BUYI舞钢BUWG确山BUQS

淇县BUQX洛宁BULN郏县BUJX汝南BURN

濮阳市BFPY新安BUXA宝丰BTBF平舆BUPI

濮阳县BUPY偃师BUYS叶县BUYX新蔡BUXN

清丰BUQF郑州市BFZZ新城区BUPS正阳BUZY

南乐BUNL荥阳BUXG周口市BFZK泌阳BUBY

范县BUFX新郑BUXZ扶沟BUFG上蔡BUSC

台前BUTQ巩义BUGY太康BUTK西平BUXP

焦作市BFJT中牟BUZM淮阳BUHY信阳市BFXI

修武BUXW新密BUXM西华BTXH固始BTGS

博爱BUBA登封BUDF川汇区BUCH罗山BULU

沁阳BUQY开封市BFKF项城BUXC息县BUXX

孟州BUMZ尉氏BUWS商水BUSA淮滨BUHB

温县BUWX通许BUTX郸城BUDC潢川BUHC

武陟BUWZ杞县BUQI鹿邑BULY商城BUSH

济源BUJY兰考BULK沈丘BUSE光山BUGS

新乡市BFXX许昌市BFXC泛区BUFQ新县BUXB

卫辉BUWH禹州BUYZ漯河市BFLE省气象台HA-MO

延津BUYJ长葛BUCG舞阳BUWY省气候中心HA-CC

省气象科学

封丘BUFE鄢陵BUYL临颍BULIHA-IMS

研究所

省气象服务

长垣BUCY襄城BUXH南阳市BFNYHA-MSC

中心

原阳BUYY商丘市BFSQ方城BUFC省防雷中心HA-LPC

辉县BUHU睢阳区BUSY社旗BUSQ省人影办HA-WMO

获嘉BUHJ梁园区BULQ唐河BUTH省信保中心HA-MIC

三门峡市BFSF睢县BUSU新野BUXE--

卢氏BTLS民权BUMQ邓州BUDZ--

渑池BUMC虞城BUYU镇平BUZP--

7

DB41/T1809—2019

BB

附录B

（资料性附录）

JSON格式示例

JSON格式：

{“resCode”:“…”,

“resMsg”:“…”,

“data”:{

[

…

…

]

}

}

JSON格式返回数据示例见表B.1。

表B.1JSON格式返回数据示例

名称数据类型说明

resCode整数型Int响应代码

resMsg字符型String响应消息

data数组型Array数据体

8

DB41/T1809—2019

CC

附录C

（资料性附录）

响应代码及响应消息

响应代码及响应消息见表C.1。

表C.1响应代码及响应消息

序号响应代码响应消息

1000获取成功

2101APPId不存在或Key错误

3102接口权限不足

4103服务不存在

5104非法请求

6105AppId当前被禁用

7106账号未登录

8201APPId、Key不能为空

9202参数不足

10203参数含非法字符

11204参数错误

12205账号不存在或密码错误

13302数据解析出错

14303资源不存在

15304配置解析出错

16305资源服务器异常

17306数据库异常

18401未知异常

9

DB41/T1809—2019

DD

附录D

（资料性附录）

气象服务数据接口说明示例

实况降雨量统计接口说明见表D.1。

表D.1实况降水量统计接口说明

接口名称实况降雨量统计

http://domain/api/wec/dc_cimiss_getTotalRain&appid=abc123&key=

接口服务资源请求地址

a1a0e37ba47b667f28cf1a229ad8b66f&timeequal=20180814150000&hours=-72

APPid：用户APPid（申请用户时获取）

Key=a1a0e37ba47b667f28cf1a229ad8b66f

参数说明

timeequal：观测时间

hours：小时累计（如：-1,-3,-6,-12,-24,-48,-72）

{“resCode”:“000”,

“resMsg”:”获取成功”,

“data”:{

[{"Cnty":"林州市

","Admin_Code_CHN":"410581000000","Station_Id_C":"53889","Value":0.0

,"Lon":113.49,"Lat":36.04},

返回结果{"Cnty":"林州市

","Admin_Code_CHN":"410581000000","Station_Id_C":"53889","Value":0.0

,"Lon":113.49,"Lat":36.04},

…

]

}

}