氣象服務(wù)數(shù)據(jù)接口規(guī)范DB41-T 1809-2019

ICS07.060

A47

DB41

河南省地方標準

DB41/T1809—2019

氣象服務(wù)數(shù)據(jù)接口規(guī)范

2019-03-19發(fā)布2019-06-19實施

河南省市場監(jiān)督管理局發(fā)布

DB41/T1809—2019

前言

本標準按照GB/T1.1—2009給出的規(guī)則起草。

本標準由河南省氣象標準化技術(shù)委員會提出并歸口。

本標準起草單位：河南省氣象服務(wù)中心。

本標準主要起草人：王婉、郭學峰、武鵬、徐鵬、馮杉、杜明哲、劉玉珠、董艷新、俆延鋒、張九

營、李寧、徐慈遠。

I

DB41/T1809—2019

氣象服務(wù)數(shù)據(jù)接口規(guī)范

1范圍

本標準規(guī)定了氣象服務(wù)數(shù)據(jù)接口的術(shù)語和定義、訪問方法、授權(quán)機制、效能要求和接口說明。

本標準適用于氣象服務(wù)數(shù)據(jù)接口的設(shè)計和使用。

2規(guī)范性引用文件

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

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

GB/T2260—2007中華人民共和國行政區(qū)劃代碼

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

氣象服務(wù)數(shù)據(jù)

在公眾、行業(yè)等氣象服務(wù)中向用戶提供的氣象數(shù)據(jù)。

4訪問方法

4.1訪問地址

氣象服務(wù)數(shù)據(jù)接口訪問地址應(yīng)采用統(tǒng)一資源定位符（URL）。URL中的服務(wù)器地址宜采用域名，不宜

采用IP地址。

4.2訪問步驟

氣象服務(wù)數(shù)據(jù)接口按以下步驟訪問：

a)用戶應(yīng)通過氣象服務(wù)數(shù)據(jù)接口單位提供的氣象服務(wù)數(shù)據(jù)系統(tǒng)平臺（以下簡稱“平臺”）申請注

冊用戶名和密碼?；驊?yīng)由氣象服務(wù)數(shù)據(jù)接口單位給用戶在平臺上創(chuàng)建用戶名和密碼；

b)用戶應(yīng)通過用戶名和密碼登陸平臺，申請氣象服務(wù)數(shù)據(jù)接口訪問賬號APPid和氣象服務(wù)數(shù)據(jù)接

口訪問密鑰Key（Key應(yīng)具有有效期，有效期內(nèi)用戶可重復使用，超過有效期系統(tǒng)為用戶重新

生成Key值）；

c)用戶應(yīng)通過用戶名和密碼登陸平臺，獲取氣象服務(wù)數(shù)據(jù)接口資源訪問地址；

d)用戶應(yīng)在氣象服務(wù)數(shù)據(jù)資源地址中加入APPid和Key，形式為“&appid=<APPid>&key=<Key>”,

生成服務(wù)資源請求地址；

e)用戶應(yīng)采用HTTP協(xié)議中的POST方法調(diào)用氣象服務(wù)數(shù)據(jù)資源請求地址，獲取返回結(jié)果。

4.3服務(wù)請求

1

DB41/T1809—2019

4.3.1服務(wù)請求字符串編碼

服務(wù)請求字符串編碼宜采用UTF-8字符集。

4.3.2服務(wù)請求參數(shù)

位置參數(shù)

位置參數(shù)可采用下列五種編碼之一：

a)按GB/T2260—2007規(guī)定的中華人民共和國行政區(qū)劃編碼，所有行政區(qū)劃的位置參數(shù)應(yīng)為12

位，如果是省、市、縣、鄉(xiāng)鎮(zhèn)等不足12位的用數(shù)字“0”補全（河南省縣級以上行政區(qū)劃代碼

見附錄A表A.1）；

b)氣象臺站區(qū)站號（河南省氣象臺站區(qū)站號見附錄A表A.2）；

c)氣象臺站字母代號編碼（河南省氣象臺站字母代號編碼見附錄A表A.3）；

d)2000國家大地坐標系經(jīng)緯度信息；

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

時間參數(shù)

時間參數(shù)宜采用YYYYMMDDHHmmSS的格式。

其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位），HH表示小時（2位，24小時制），

mm表示分鐘（2位），SS表示秒（2位）。

如無特殊說明，時間應(yīng)為UTC時間。

4.3.3請求字符串的組成

服務(wù)請求字符串應(yīng)包含服務(wù)請求參數(shù)、訪問密鑰等信息，不應(yīng)包含明文密碼等敏感信息。

4.4服務(wù)響應(yīng)

4.4.1返回格式

氣象服務(wù)數(shù)據(jù)接口宜以JSON格式返回結(jié)果（JSON格式示例見附錄B）。

返回結(jié)果應(yīng)包括響應(yīng)代碼、響應(yīng)消息和數(shù)據(jù)體三部分。其中：

a)響應(yīng)代碼resCode格式宜為整數(shù)型（響應(yīng)代碼見附錄C）；

b)響應(yīng)消息resMsg格式宜為字符型，返回內(nèi)容應(yīng)為響應(yīng)代碼resCode的詳細說明（響應(yīng)消息見

附錄C）；

c)數(shù)據(jù)體data格式宜為數(shù)組型，返回內(nèi)容應(yīng)為氣象服務(wù)數(shù)據(jù)的具體描述。

4.4.2返回結(jié)果編碼

返回結(jié)果編碼宜采用UTF-8字符集。

5授權(quán)機制

5.1用戶授權(quán)要求

氣象服務(wù)數(shù)據(jù)接口宜通過加密算法對用戶進行授權(quán)。

5.2用戶授權(quán)算法

2

DB41/T1809—2019

宜將接口請求參數(shù)按照順序拼接成字符串，加上時間戳（格式為YYYYMMDD）形成新的字符串，對新

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

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

6效能要求

6.1并行性

氣象服務(wù)數(shù)據(jù)接口應(yīng)提供多用戶并行訪問支持。

6.2響應(yīng)時間

氣象服務(wù)數(shù)據(jù)接口響應(yīng)時間應(yīng)小于500ms。

7接口說明

氣象服務(wù)數(shù)據(jù)接口單位應(yīng)提供接口說明，并應(yīng)與氣象服務(wù)數(shù)據(jù)接口一起提交用戶使用。

接口說明應(yīng)包括氣象服務(wù)數(shù)據(jù)接口描述、調(diào)用請求方式、參數(shù)說明、常用參數(shù)代碼等內(nèi)容，并給出

數(shù)據(jù)接口調(diào)用示例代碼（數(shù)據(jù)接口說明示例見附錄D）。

3

DB41/T1809—2019

AA

附錄A

（資料性附錄）

位置參數(shù)編碼

A.1河南省縣以上行政區(qū)劃代碼

見表A.1。

表A.1河南省縣以上行政區(qū)劃代碼

單位名稱行政區(qū)劃單位名稱行政區(qū)劃單位名稱行政區(qū)劃

河南省410000000000內(nèi)黃縣410527000000南陽市411300000000

鄭州市410100000000林州市410581000000宛城區(qū)411302000000

中原區(qū)410102000000鶴壁市410600000000臥龍區(qū)411303000000

二七區(qū)410103000000鶴山區(qū)410602000000南召縣411321000000

管城回族區(qū)410104000000山城區(qū)410603000000方城縣411322000000

金水區(qū)410105000000淇濱區(qū)410611000000西峽縣411323000000

上街區(qū)410106000000?？h410621000000鎮(zhèn)平縣411324000000

惠濟區(qū)410108000000淇縣410622000000內(nèi)鄉(xiāng)縣411325000000

中牟縣410122000000新鄉(xiāng)市410700000000淅川縣411326000000

鞏義市410181000000紅旗區(qū)410702000000社旗縣411327000000

滎陽市410182000000衛(wèi)濱區(qū)410703000000唐河縣411328000000

新密市410183000000鳳泉區(qū)410704000000新野縣411329000000

新鄭市410184000000牧野區(qū)410711000000桐柏縣411330000000

登封市410185000000新鄉(xiāng)縣410721000000鄧州市411381000000

開封市410200000000獲嘉縣410724000000商丘市411400000000

龍亭區(qū)410202000000原陽縣410725000000梁園區(qū)411402000000

順河回族區(qū)410203000000延津縣410726000000睢陽區(qū)411403000000

鼓樓區(qū)410204000000封丘縣410727000000民權(quán)縣411421000000

禹王臺區(qū)410205000000長垣縣410728000000睢縣411422000000

祥符區(qū)410212000000衛(wèi)輝市410781000000寧陵縣411423000000

杞縣410221000000輝縣市410782000000柘城縣411424000000

通許縣410222000000焦作市410800000000虞城縣411425000000

尉氏縣410223000000解放區(qū)410802000000夏邑縣411426000000

蘭考縣410225000000中站區(qū)410803000000永城市411481000000

洛陽市410300000000馬村區(qū)410804000000信陽市411500000000

老城區(qū)410302000000山陽區(qū)410811000000浉河區(qū)411502000000

西工區(qū)410303000000修武縣410821000000平橋區(qū)411503000000

4

DB41/T1809—2019

表A.1河南省縣以上行政區(qū)劃代碼（續(xù)）

單位名稱行政區(qū)劃單位名稱行政區(qū)劃單位名稱行政區(qū)劃

瀍河回族區(qū)410304000000博愛縣410822000000羅山縣411521000000

澗西區(qū)410305000000武陟縣410823000000光山縣411522000000

吉利區(qū)410306000000溫縣410825000000新縣411523000000

洛龍區(qū)410311000000沁陽市410882000000商城縣411524000000

孟津縣410322000000孟州市410883000000固始縣411525000000

新安縣410323000000濮陽市410900000000潢川縣411526000000

欒川縣410324000000華龍區(qū)410902000000淮濱縣411527000000

嵩縣410325000000清豐縣410922000000息縣411528000000

汝陽縣410326000000南樂縣410923000000周口市411600000000

宜陽縣410327000000范縣410926000000川匯區(qū)411602000000

洛寧縣410328000000臺前縣410927000000扶溝縣411621000000

伊川縣410329000000濮陽縣410928000000西華縣411622000000

偃師市410381000000許昌市411000000000商水縣411623000000

平頂山市410400000000魏都區(qū)411002000000沈丘縣411624000000

新華區(qū)410402000000建安區(qū)411003000000鄲城縣411625000000

衛(wèi)東區(qū)410403000000鄢陵縣411024000000淮陽縣411626000000

石龍區(qū)410404000000襄城縣411025000000太康縣411627000000

湛河區(qū)410411000000禹州市411081000000鹿邑縣411628000000

寶豐縣410421000000長葛市411082000000項城市411681000000

葉縣410422000000漯河市411100000000駐馬店市411700000000

魯山縣410423000000源匯區(qū)411102000000驛城區(qū)411702000000

郟縣410425000000郾城區(qū)411103000000西平縣411721000000

舞鋼市410481000000召陵區(qū)411104000000上蔡縣411722000000

汝州市410482000000舞陽縣411121000000平輿縣411723000000

安陽市410500000000臨潁縣411122000000正陽縣411724000000

文峰區(qū)410502000000三門峽市411200000000確山縣411725000000

北關(guān)區(qū)410503000000湖濱區(qū)411202000000泌陽縣411726000000

殷都區(qū)410505000000陜州區(qū)411203000000汝南縣411727000000

龍安區(qū)410506000000澠池縣411221000000遂平縣411728000000

安陽縣410522000000盧氏縣411224000000新蔡縣411729000000

湯陰縣410523000000義馬市411281000000濟源市419001000000

滑縣410526000000靈寶市411282000000--

A.2河南省氣象臺站區(qū)站號

見表A.2。

5

DB41/T1809—2019

表A.2河南省氣象臺站區(qū)站號

單位名稱區(qū)站號單位名稱區(qū)站號單位名稱區(qū)站號單位名稱區(qū)站號

林縣53889洛寧57066嵩縣57162鄧州57274

安陽53898盧氏57067內(nèi)鄉(xiāng)57169泌陽57281

沁陽53972新安57070平頂山57171桐柏57285

淇縣53974孟津57071魯山57173信陽農(nóng)試站57289

濟源53978孟縣57072鎮(zhèn)平57175駐馬店57290

博愛53979洛陽57073南召57176平玉57292

焦作53982伊川57074舞鋼工區(qū)57177新蔡57293

封丘53983汝州57075南陽57178確山57294

修武53984偃師57076方城57179正陽57295

輝縣53985欒川57077郟縣57180息縣57296

新鄉(xiāng)53986汝陽57078寶豐57181信陽57297

武陡53987溫縣57079襄城57182羅山57298

獲加53988鞏縣57080臨潁57183光山57299

原陽53989滎陽57081葉縣57184雞公山57390

鶴壁53990登封57082舞陽57185新縣57396

湯陰53991鄭州57083漯河57186睢縣58001

?？h53992密縣57085社旗57187民權(quán)58004

內(nèi)黃53993新鄭57086西平57188商丘58005

衛(wèi)輝53994長葛57087遂平57189虞城58006

滑縣53995禹州57088黃泛區(qū)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鄭州農(nóng)試站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內(nèi)鄉(xiāng)BUNX

安陽縣BTAY洛陽市BFLB寧陵BUNI淅川BUXI

湯陰BUTY孟津BTMJ夏邑BUXY西峽BTXA

內(nèi)黃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新城區(qū)BUPS正陽BUZY

南樂BUNL滎陽BUXG周口市BFZK泌陽BUBY

范縣BUFX新鄭BUXZ扶溝BUFG上蔡BUSC

臺前BUTQ鞏義BUGY太康BUTK西平BUXP

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

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

博愛BUBA登封BUDF川匯區(qū)BUCH羅山BULU

沁陽BUQY開封市BFKF項城BUXC息縣BUXX

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

溫縣BUWX通許BUTX鄲城BUDC潢川BUHC

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

濟源BUJY蘭考BULK沈丘B(yǎng)USE光山BUGS

新鄉(xiāng)市BFXX許昌市BFXC泛區(qū)BUFQ新縣BUXB

衛(wèi)輝BUWH禹州BUYZ漯河市BFLE省氣象臺HA-MO

延津BUYJ長葛B(yǎng)UCG舞陽BUWY省氣候中心HA-CC

省氣象科學

封丘B(yǎng)UFE鄢陵BUYL臨潁BULIHA-IMS

研究所

省氣象服務(wù)

長垣BUCY襄城BUXH南陽市BFNYHA-MSC

中心

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

輝縣BUHU睢陽區(qū)BUSY社旗BUSQ省人影辦HA-WMO

獲嘉BUHJ梁園區(qū)BULQ唐河BUTH省信保中心HA-MIC

三門峽市BFSF睢縣BUSU新野BUXE--

盧氏BTLS民權(quán)BUMQ鄧州BUDZ--

澠池BUMC虞城BUYU鎮(zhèn)平BUZP--

7

DB41/T1809—2019

BB

附錄B

（資料性附錄）

JSON格式示例

JSON格式：

{“resCode”:“…”,

“resMsg”:“…”,

“data”:{

[

…

…

]

}

}

JSON格式返回數(shù)據(jù)示例見表B.1。

表B.1JSON格式返回數(shù)據(jù)示例

名稱數(shù)據(jù)類型說明

resCode整數(shù)型Int響應(yīng)代碼

resMsg字符型String響應(yīng)消息

data數(shù)組型Array數(shù)據(jù)體

8

DB41/T1809—2019

CC

附錄C

（資料性附錄）

響應(yīng)代碼及響應(yīng)消息

響應(yīng)代碼及響應(yīng)消息見表C.1。

表C.1響應(yīng)代碼及響應(yīng)消息

序號響應(yīng)代碼響應(yīng)消息

1000獲取成功

2101APPId不存在或Key錯誤

3102接口權(quán)限不足

4103服務(wù)不存在

5104非法請求

6105AppId當前被禁用

7106賬號未登錄

8201APPId、Key不能為空

9202參數(shù)不足

10203參數(shù)含非法字符

11204參數(shù)錯誤

12205賬號不存在或密碼錯誤

13302數(shù)據(jù)解析出錯

14303資源不存在

15304配置解析出錯

16305資源服務(wù)器異常

17306數(shù)據(jù)庫異常

18401未知異常

9

DB41/T1809—2019

DD

附錄D

（資料性附錄）

氣象服務(wù)數(shù)據(jù)接口說明示例

實況降雨量統(tǒng)計接口說明見表D.1。

表D.1實況降水量統(tǒng)計接口說明

接口名稱實況降雨量統(tǒng)計

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

接口服務(wù)資源請求地址

a1a0e37ba47b667f28cf1a229ad8b66f&timeequal=20180814150000&hours=-72

APPid：用戶APPid（申請用戶時獲?。?/p>

Key=a1a0e37ba47b667f28cf1a229ad8b66f

參數(shù)說明

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},

返回結(jié)果{"Cnty":"林州市

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

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

…

]

}

}