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

ICS07.060A47DB41河南省地方标准DB41/T1809—2019气象服务数据接口规范2019-03-19发布2019-06-19实施河南省市场监督管理局发布DB41/T1809—2019I前言本标准按照GB/T1.1—2009给出的规则起草。本标准由河南省气象标准化技术委员会提出并归口。本标准起草单位：河南省气象服务中心。本标准主要起草人：王婉、郭学峰、武鹏、徐鹏、冯杉、杜明哲、刘玉珠、董艳新、俆延锋、张九营、李宁、徐慈远。DB41/T1809—20191气象服务数据接口规范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服务请求DB41/T1809—201924.3.1服务请求字符串编码服务请求字符串编码宜采用UTF-8字符集。4.3.2服务请求参数4.3.2.1位置参数位置参数可采用下列五种编码之一：a)按GB/T2260—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用户授权算法DB41/T1809—20193宜将接口请求参数按照顺序拼接成字符串，加上时间戳（格式为YYYYMMDD）形成新的字符串，对新字符串做MD5消息摘要算法的32位加密，形成Key值。其中，YYYY表示年（4位），MM表示月（2位），DD表示日（2位）。6效能要求6.1并行性气象服务数据接口应提供多用户并行访问支持。6.2响应时间气象服务数据接口响应时间应小于500ms。7接口说明气象服务数据接口单位应提供接口说明，并应与气象服务数据接口一起提交用户使用。接口说明应包括气象服务数据接口描述、调用请求方式、参数说明、常用参数代码等内容，并给出数据接口调用示例代码（数据接口说明示例见附录D）。DB41/T1809—20194AA附录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平桥区411503000000DB41/T1809—20195表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。DB41/T1809—20196表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