2930 气象服务信息数据接口规范（规范）.docVIP

ICS? FORMTEXT 07.060 FORMTEXT A 47 FORMTEXT ????? DB FORMTEXT 37 FORMTEXT 山东省地方标准 DB FORMTEXT 37/T 2930—2017 FORMTEXT ????? FORMTEXT 气象服务信息数据接口规范 FORMTEXT Specification for weather service information data interface 2017-02-21发布 2017-03-21实施 FORMTEXT 山东省质量技术监督局???发布 DB37/T 2930—2017 PAGE 3 目??次 TOC \h \z \t前言、引言标题,1,参考文献、索引标题,1,章标题,1,参考文献,1,附录标识,1 前言 II 1　范围 1 2　规范性引用文件 1 3　术语和定义 1 4　访问方法 2 5　授权机制 4 6　效能要求 4 7　接口说明 4 附录A（资料性附录）　JSON格式和XML格式示例 5 附录B（资料性附录）　返回码清单 6 附录C（资料性附录）　天气预报编码 8 附录D（资料性附录）　接口说明示例 10 参考文献 11 前??言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由山东省气象标准化技术委员会（鲁TC 16）提出并归口。 本标准起草单位：山东省气象服务中心。 本标准主要起草人：周雪松、李玉华、褚希、徐彩艳、任广治、张鹏、姚蔚、石春玲。 气象服务信息数据接口规范 范围 本标准规定了气象服务信息的访问方法、授权机制、效能要求和接口说明。 本标准适用于气象行业和相关气象服务信息应用单位或个人进行气象服务信息系统的设计、研发和维护。 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260　中华人民共和国行政区划代码 RFC 2616　超文本传输协议（Hypertext Transfer Protocol） 术语和定义 下列术语和定义适用于本文件。 域名系统　DNS　domain name system 因特网上作为域名和IP地址相互映射的一个分布式数据库，能够使用户更方便的访问互联网，而不用去记住能够被机器直接读取的IP数串。 可扩展标记语言　XML　extensible markup language 一种用于标记电子文件使其具有结构性的标记语言。 可从以下网址获得：（/TR/REC-xml/）。 JavaScript对象表示法　JSON　javascript object notation 一种基于Javascript的轻量级数据交换格式。 统一资源定位符　URL　uniform resoure locator 对可以从互联网上得到的资源的位置和访问方法的一种简洁的表示。 表述性状态转移　REST　representational state transfer 一组架构约束条件和原则，通常基于使用HTTP、URI、XML以及HTML这些现有的广泛流行的协议和标准，根据这些原则设计以系统资源为中心的Web服务。 包括使用不同语言编写的客户端如何通过HTTP处理和传输资源状态。 气象服务信息　weather service information 在决策、公众和专业气象服务中向政府、社会和生产部门提供的信息。 气象服务信息数据格式类别包括文本、数字、图片、视频等。 访问方法 访问方式 对气象服务信息的访问对应唯一的资源标识符（URL网址），应采用RFC 2616中的HTTP协议的GET方式进行。 服务请求字符串及返回结果编码宜采用RFC 3629/STD 63（2003）定义的UTF-8字符集。如使用其他字符集，应在返回结果中标明。 访问步骤 需授权气象服务信息数据资源访问步骤 对于需要授权的气象服务信息数据接口（即需要用户认证的服务），访问步骤如下： 身份认证并获取授权：通过平台注册用户申请相关服务资源，经审核后获取合法授权（用户名密码、IP认证或Key值）； 获取服务资源地址：通过平台获取气象服务信息数据接口资源访问地址； 构建加密服务资源的访问地址：在气象服务信息数据访问接口资源地址上加入用户名和密码或Key值参数，形式为“username=usernamepassword=password”或“key=key”，生成新的服务网址（经过IP认证的用户可以直接访问）； 服务资源访问：通过加密的气象信息服务资源访问地址访问气象服务信息，获取返回结果。 不需授权气象服务信息数