搜索
书书书犐犆犛３５．１１０犔７９!#$%&’’()*犌犅／犜３７９７６—２０１９!# $%&’()*+,-.)/012犐狀狋犲狉狀犲狋狅犳狋犺犻狀犵狊—犛犿犪狉狋犺狅狋犲犾犪狆狆犾犻犮犪狋犻狅狀—犌犲狀犲狉犪犾狋犲犮犺狀犻犮犪犾狉犲狇狌犻狉犲犿犲狀狋狊狅犳狋犺犲狆犾犪狋犳狅狉犿犻狀狋犲狉犳犪犮犲２０１９０８３０34２０２００３０１56’(+,-./012!’’()*3/045634书书书目 次前言Ⅲ…………………………………………………………………………………………………………１ 范围１………………………………………………………………………………………………………２ 规范性引用文件１…………………………………………………………………………………………３ 术语和定义１………………………………………………………………………………………………４ 缩略语１……………………………………………………………………………………………………５ 概述１………………………………………………………………………………………………………６ 平台接口２………………………………………………………………………………………………… ６．１ 应用技术要求２……………………………………………………………………………………… ６．２ 接口定义方式和数据类型说明３…………………………………………………………………… ６．２．１ 数据接口定义方式３…………………………………………………………………………… ６．２．２ 接口数据类型４………………………………………………………………………………… ６．３ ＰＭＳ接口５…………………………………………………………………………………………… ６．３．１ 基础代码获取接口５…………………………………………………………………………… ６．３．２ 客房管理１０……………………………………………………………………………………… ６．３．３ 客房订单２１……………………………………………………………………………………… ６．３．４ 前台业务４６……………………………………………………………………………………… ６．３．５ 会员服务８６……………………………………………………………………………………… ６．４ 酒店其他管理系统接口１１０………………………………………………………………………… ６．４．１ 门锁服务１１０…………………………………………………………………………………… ６．４．２ 客房控制服务１３１……………………………………………………………………………… ６．４．３ 客房娱乐服务１３４……………………………………………………………………………… ６．４．４ 公安数据接入１４６………………………………………………………………………………７ 接口安全要求１４８………………………………………………………………………………………… ７．１ 结构安全１４８………………………………………………………………………………………… ７．２ 访问控制１４９………………………………………………………………………………………… ７．３ 安全审计１４９………………………………………………………………………………………… ７．４ 边界完整性检查１４９………………………………………………………………………………… ７．５ 入侵防范１４９………………………………………………………………………………………… ７．６ 网络设备防护１４９……………………………………………………………………………………Ⅰ犌犅／犜３７９７６—２０１９前 言 本标准按照ＧＢ／Ｔ１．１—２００９给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国信息技术标准化技术委员会（ＳＡＣ／ＴＣ２８）提出并归口。本标准起草单位：中国电子技术标准化研究院、新新人类（北京）科技有限公司、智慧壹号（北京）酒店管理有限公司、杭州绿云软件有限公司、深圳赛西信息技术有限公司、公安部第三研究所、山东比特智能科技股份有限公司、快住智能科技（苏州）有限公司、上海别样红信息技术有限公司、上海逸邻网络科技有限公司、广东必达保安系统有限公司、惠州市尊宝智能控制股份有限公司、深圳市盛阳科技股份有限公司、杭州云柚科技有限公司、ＴＣＬ王牌电器（惠州）有限公司、深圳欢旅科技有限公司、常州市邦威电子科技有限公司。本标准起草人：张晖、郭迪胜、耿力、李孟良、杨宏、信宏业、赵焕焱、荀亮亮、路小北、谷慧敏、曹现贵、朱彤、黄华、杨铭魁、陈海滨、郭迎光、冯震维、陈伟禧、黄晓凌、张勇、吕坡、张敬宇、曾文涛、刘乃钢、王建青、余晖、陈雪明、唐建国、陈妙强、黄俭、杨枫、穆林、张华、李翔、邹子平、裘永强、沈伟明、李桂琴、朱家川、王加梁、李广飞、闫宏河、闻涛、李云鹏、刘卫东、田彩云、李东升、周山、王烨、王浩、王!涛、汤铭、孟周俊、俞海钟、刘宗科、邹宇航、杨诗兵、李俱顺。Ⅲ犌犅／犜３７９７６—２０１９物联网 智慧酒店应用平台接口通用技术要求１ 范围本标准规定了基于物联网技术的智慧酒店应用平台接口通用技术要求。本标准适用于基于物联网技术的智慧酒店应用平台接口设计。２ 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ＧＢ／Ｔ３３７４５—２０１７ 物联网 术语３ 术语和定义ＧＢ／Ｔ３３７４５—２０１７界定的以及下列术语和定义适用于本文件。３．１ 智慧酒店 狊犿犪狉狋犺狅狋犲犾通过应用先进的信息和通信技术，实现管理数字化、网络化和智能化的酒店。３．２ 综合信息管理平台 犻狀狋犲犵狉犪狋犲犱犻狀犳狅狉犿犪狋犻狅狀犿犪狀犪犵犲犿犲狀狋狆犾犪狋犳狅狉犿将酒店的客户管理、客房管理、接待管理、账务管理、审核管理、销售管理等多个管理模块或系统汇集并形成的管理平台。３．３ 平台接口 狆犾犪狋犳狅狉犿犻狀狋犲狉犳犪犮犲平台内部子系统、子模块之间，以及该平台与外部平台、系统之间的相互连接与交互的接口。４ 缩略语下列缩略语适用于本文件。ＯＯＯ 待修房（ＯｕｔｏｆＯｒｄｅｒ）ＰＭＳ 酒店管理系统（ＰｒｏｐｅｒｔｙＭａｎａｇｅｍｅｎｔＳｙｓｔｅｍ）５ 概述智慧酒店应用一般通过基于物联网技术的智慧酒店综合信息管理平台实现，平台架构如图１所示，由ＰＭＳ和酒店其他管理系统组成。物联网传感单元信息通过事务处理系统及其他系统与ＰＭＳ进行数据交换，智慧酒店通过该平台提供应用服务。１犌犅／犜３７９７６—２０１９图１ 基于物联网的智慧酒店综合信息管理平台架构 智慧酒店综合信息管理平台接口包括ＰＭＳ接口和酒店其他管理系统接口。ＰＭＳ接口包括：基础代码接口、客房管理接口、客房订单接口、前台业务接口和会员服务接口等。酒店其他管理系统接口包括：门锁服务接口、客房控制接口、人工智能机器人服务接口、智能消防控制接口、客房娱乐接口和公安传输数据接口等。智慧酒店综合信息管理平台的各接口之间可进行相互调用，也可以供外部应用服务调用，以满足具体业务服务需求。６ 平台接口６．１ 应用技术要求智慧酒店应围绕物联网六域模型体系建立包括ＰＭＳ及相关联的应用技术内容。智慧酒店建设应用技术体系架构如图２所示。２犌犅／犜３７９７６—２０１９图２ 智慧酒店建设应用技术体系架构 ６．２ 接口定义方式和数据类型说明６．２．１ 数据接口定义方式规定如下：ａ） 数据接口分类按ＰＭＳ接口和酒店其他管理系统接口归纳各子类数据接口，并在各类数据接口进一步划分为细类数据接口。３犌犅／犜３７９７６—２０１９ｂ） 接口格式描述１） 各个接口定义按以下格式描述：条款号接口名（说明：使用中文和原语给出接口名）［功能说明］（说明：简要陈述该接口的功能）［请求参数］（说明：用以下列表形式给出所请求的参数）字段中文名称数据类型数量说明用原语给出该字段包含的参数名该参数的中文名用于描述该参数的数据类型所请求的该参数的数量对前面栏目的补充说明————— ［响应数据］（说明：用以下列表形式给出响应数据）字段中文名称数据类型数量说明用原语给出该字段包含的数据名该参数据的中文名用于描述该数据的数据类型所请求的该数据的数量对前面栏目的补充说明————— ＸＸＸＸＤｔｏ（说明：１．Ｄｔｏ表示数据传输对象；２．“Ｄｔｏ”前的“ＸＸＸＸ”，对于基础代码获取接口，用接口原语名中“ｇｅｔ”后面的部分取代；对于ＰＭＳ接口或酒店其他管理系统接口，用接口原语名取代；３．个别接口包含不止一个此项）字段中文名称数据类型数量说明用原语给出该字段包含的数据名该字段的中文名用于描述该字段的数据类型所请求的该字段的数量对前面栏目的补充说明————— ［请求示例］（说明：下面给出具体请求示例）２） 关于接口定义中的“数量”，说明如下：１：表示有且仅有一个。０．．狀：表示可以没有，也可以为多个，数量没有上限。１．．狀：表示最少一个，可以为多个，数量没有上限。３） 关于接口定义中的“示例”，本标准主要采用国际通行的数据交换数据格式Ｊｓｏｎ来说明。６．２．２ 接口数据类型包括如下几种类型：ａ） 字符型数据，用Ｓｔｒｉｎｇ表示；ｂ） 整数型数据，用Ｎｕｍｂｅｒ表示；ｃ） 小数型数据，用Ｄｅｃｉｍａｌ表示；ｄ） 对象型数据（用后缀Ｄｔｏ［］的字符串表示），自定义数据传输对象，该类型的数据应进行单独说明。４犌犅／犜３７９７６—２０１９６．３ 犘犕犛接口６．３．１ 基础代码获取接口６．３．１．１ 获取国家信息犵犲狋犆狅狌狀狋狉犻犲狊［功能说明］获取国家信息。［请求参数］字段中文名称数据类型数量说明ｈｏｔｅｌＧｒｏｕｐＣｏｄｅ酒店集团代码Ｓｔｒｉｎｇ１— ［响应数据］字段中文名称数据类型数量说明ｒｅｓｕｌｔＣｏｄｅ结果代码Ｓｔｒｉｎｇ１字段操作结果ｒｅｓｕｌｔＭｓｇ结果信息Ｓｔｒｉｎｇ１返回提示信息ｒｅｓｕｌｔＯｂｊ结果对象ＣｏｕｔｒｙＤｔｏ［］０．．狀返回数据对象 ＣｏｕｔｒｙＤｔｏ字段中文名称数据类型数量说明ｃｏｄｅ代码Ｓｔｒｉｎｇ１—ｄｅｓｃｒｉｐｔ名称Ｓｔｒｉｎｇ１— ［请求示例］｛＂ｈｏｔｅｌＧｒｏｕｐＣｏｄｅ＂：＂ＨＴＬＧ＂｝［返回示例］｛＂ｒｅｓｕｌｔＣｏｄｅ＂：０，＂ｒｅｓｕｌｔＭｓｇ＂：＂查询成功＂，＂ｒｅｓｕｌｔＩｎｆｏ＂：［ ｛＂ｃｏｄｅ＂：＂ＣＨＮ＂，＂ｄｅｓｃｒｉｐｔ＂：＂中国＂ ｝， ｛＂ｃｏｄｅ＂：＂ＵＳＡ＂，＂ｄｅｓｃｒｉｐｔ＂：＂美国＂ ｝ ］｝５犌犅／犜３７９７６—２０１９６．３．１．２ 获取城市信息犵犲狋犆犻狋犻犲狊［功能说明］获取指定酒店集团的城市信息。［请求参数］字段中文名称数据类型数量说明ｈｏｔｅｌＧｒｏｕｐＣｏｄｅ酒店集团代码Ｓｔｒｉｎｇ１— ［响应数据］字段中文名称数据类型数量说明ｒｅｓｕｌｔＣｏｄｅ结果代码Ｓｔｒｉｎｇ１—ｒｅｓｕｌｔＭｓｇ结果信息Ｓｔｒｉｎｇ１—ｒｅｓｕｌｔＩｎｆｏ返回信息ＣｉｔｙＤｔｏ［］０．．狀— ＣｉｔｙＤｔｏ字段中文名称数据类型数量说明ｃｏｄｅ代码Ｓｔｒｉｎｇ１—ｄｅｓｃｒｉｐｔ名称Ｓｔｒｉｎｇ１— ［请求示例］｛＂ｈｏｔｅｌＧｒｏｕｐＣｏｄｅ＂：＂ＨＴＬＧ＂｝［返回示例］｛＂ｒｅｓｕｌｔＣｏｄｅ＂：０，＂ｒｅｓｕｌｔＭｓｇ＂：＂查询成功＂，＂ｒｅｓｕｌｔＩｎｆｏ＂：［ ｛＂ｃｏｄｅ＂：＂ＨＺ＂，＂ｄｅｓｃｒｉｐｔ＂：＂杭州＂ ｝， ｛＂ｃｏｄｅ＂：＂ＳＨ＂，＂ｄｅｓｃｒｉｐｔ＂：＂上海＂ ｝ ］｝６．３．１．３ 获取证件类型信息犵犲狋犐犱犆狅犱犲狊［功能说明］获取证件类型信息。６犌犅／犜３７９７６—２０１９［请求参数］字段中文名称数据类型数量说明ｈｏｔｅｌＧｒｏｕｐＣｏｄｅ酒店集团代码Ｓｔｒｉｎｇ１—ｈｏｔｅｌＣｏｄｅ酒店代码Ｓｔｒｉｎｇ１— ［响应数据］字段中文名称数据类型数量说明ｒｅｓｕｌｔＣｏｄｅ结果代码Ｓｔｒｉｎｇ１—ｒｅｓｕｌｔＭｓｇ结