(高清版)GB∕T 38052.3-2019 智能家用电器系统互操作 第3部分：服务平台间接口规范

智能家用电器系统互操作第3部分：服务平台间接口规范Part3:Interfacespecificationbetweenser国家市场监督管理总局GB/T38052.3—2019 I 2规范性引用文件 2 2 2 3 3 5 5 5 6 77.4设备管理服务接口 7.5信息同步服务接口 7.6编码解析服务接口 8RetCode说明 本部分为GB/T38052的第3部分。1GB/T38052.1智能家用电器系统互操作第1部分：术语HTTPS:有安全套接层的超文本传输协议(HyperTextTransferProtocoloverSecureSocket2图1。4行业服务平台接口采用HTTPS方式，接口提供的统一接入点为https://domain:port/p厂商服务平台接口采用HTTPS方式，接口3服务平台间接口使用的数据类型见表1。中文名称说明字符串弱类型语言(如Php、Python等)中的字符串Java中的Int、Byte、Short、时间戳指格林威治时间，即1970年01月01日00时00分00秒000毫秒(北京时间1970年01月01日08时00分00秒000毫秒)起至时间的总毫秒数，文本表达对应JSON中的“对象符号”,方便平台与家电间多个JSON对象符号的集合，应由平台及家电自行解析为本地数据类型使用消息结构见表2,HTTPBody由消息头和消息体组成，其中消息头和消息体的数据是基于JSON消息头格式见表3。4中文名称说明98其他情况取值唯一命令方向211——行业平台到其他平台命令12——其他平台到行业平台命令其他：预留1至少支持以下方式的一种：其他：预留1其他：预留时间戳8时间戳，精确到毫秒，时间为该消息生成时间5参数名说明应采用非对称加密算法保证MessageBody信息在传输过程的机密性。公钥最低安全长度不低于2048位，宜使用RSA算法。b)IP验证仅为初步验证请求来源的合法性方法。收集所有相关厂商服务平台的IP,创建厂商服行业服务平台对于来自单一请求方的请求有请求限制。对于不同的请求配额，超过限制的请求将被行业服务平台拒绝服务。请求频率的上限、配额再6a)平台管理服务接口；b)用户管理服务接口；的平台唯一标识码(UPlatID)。厂商服务平台中保留该UPlatID的信息，在厂商服务平台实现互联通信中使用UPlatID标识该厂商服务平台。行业服务平台可通过UPlatID对接入平台的操作权限和服厂商服务平台平台注册请求行业服务平台平台注册应答服务平台注册接口见表5。请求参数(厂商服务平台向行业服务平台发起请求):数据类型说明服务平台类型(厂商服务平台默认为01),见响应参数(行业服务平台向厂商服务平台响应):数据类型说明a)厂商服务平台与行业服务平台通过合约关系进行平台注册，行业服务平台为厂商服务平台分配了UPlatID。d)行业服务平台给厂商控制终端用户分配一个UUserID,厂商服务平台中建立UUserID和78注册互联互通用户请求参数(厂商服务平台向行业服务平台发起互联互通用户注册请求):数据类型说明互联互通用户名响应参数(行业服务平台向厂商服务平台响应互联互通用户注册):数据类型说明验证码确认互联互通用户注销接口见表7。互联互通用户注销注销跨平台用户请求参数(厂商服务平台向行业服务平台发起互联互通用户注销请求):数据类型说明响应参数(行业服务平台向厂商服务平台响应互联互通用户注销):数据类型说明9a)用户使用A厂商控制终端通过扫描条码或二维码的方式获取B厂商家电的UDeviceID,且用户A添加B厂商家电请求UUserID、UDeviceIDB厂商服务终端a)用户使用A厂商控制终端通过扫描条码或二维码的方式获取B厂商家电的UDeviceID,且c)B厂商服务平台确认该UDeviceID是否有属主UserID,如B厂商服务平台确认该UDeviceID已有属主UserID,则B厂商服务平台将核对该属主UserID注册时预留的手机号码以及家电的属主用户名和密码，经B厂商服务平台验证正确后，在B厂商服务平台中建立BB厂商服务平台根据UUserID建立B平B厂商家电有属并通过属主确认用户A添加B家电请求第三方用户注册接口见表8。厂商服务平台通过行业服务平台向第三方厂商服务平请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起用户注册请求):数据类型说明用户唯一码用户名响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应用户注册请求):数据类型说明b)厂商控制终端向厂商服务平台发送请求注销该UUserID,厂商平台确定该UUserID非本厂商直接管理的用户，则向行业服务平台发送注销请求，行业服务平台c)该用户的管理厂商平台向该UUserID注册的手机号码发送验证码，A厂商控制终端输入正确e)将UUserID相关的用户和设备信息同步给行业服务平台和A厂商服务平台。使用厂商控制终端注销第三方用户流程见图7。第三方用户注销接口见表9。第三方用户注销厂商服务平台通过行业服务平台向第三方厂商服务平台进行第三方用户注销请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起用户注销请求):数据类型说明用户唯一码用户名响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应用户注销):数据类型说明/user/verificationCod请求参数(用户申请验证码):数据类型说明响应参数(被请求方反馈验证码):数据类型说明表11手机验证码验证接口/user/verificationCo请求参数(用户输入验证码):数据类型说明响应参数(被请求方验证):数据类型说明跨平台用户获取家电的UDeviceID,通过行业服务平台和厂商服务平台上进行该用户和家电的绑再实现对该设备的绑定。流程见图8。a)用户使用A厂商控制终端通过扫描条码或二维码的方式获取B厂商家电的UDeviceID,且UDeviceID需采用明码方式编码。b)A厂商控制终端将UUserID和UDeviceID通过A厂商服务平台将请求发送到行业服务平台，而行业服务平台对UDeviceID进行编码解析，获取到B厂商服务平台地址信息，将UUserID和UDeviceID绑定请求信息发送到B厂商服务平台。c)B厂商平台确定该UUserID已经与本平台中的UserID相关联，则建立UUserID和属主B厂商服务跨平台用户和家电绑定接口见表12。表12跨平台用户和家电绑定接口/user/thirdpartyBin请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起家电绑定请求):数据类型说明响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应家电绑定请求):数据类型说明绑定。流程见图9。a)用户使用A厂商控制终端启动用户和家电解绑程序。b)A厂商控制终端将UUserID和UDeviceID通过A厂商服务平台将请求发送到行业服务平台，而行业服务平台对UDeviceID进行编码解析，获取到B厂商服务平台地址信息，将UUserID和UDeviceID解绑请求信息发送到B厂商服务平台。c)B厂商平台发送验证码给该UUserID注册的手机号码发送验证码，平台确认用户输入正确的验证码后，解除UUserID和UDeviceID的绑定关系，相关联的从属用户也同时解除与该终端A厂商服务B厂商服务平台用户A和B家电解除绑定请求→跨平台用户和家电解绑接口见表13。表13跨平台用户和家电解绑接口/user/thirtyPartyUnbind解除跨平台用户和家电之间的绑定关系请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起家电解绑请求):说明响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应家电解绑请求):说明跨平台用户通过获取厂商家电的描述文件，解析生成相关的操作界面。跨终端-用户A申请下载B家电描述文件用户A申请下载B家电描述文件图10行业服务平台提供设备描述文件流程A厂商控制A厂商服务用户A查询B家电描述文件→查询设备描述文件接口见表14。表14查询设备描述文件接口请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起查询设备描述文件请求):说明响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应查询设备描述文件):说明请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起获取设备描述文件请求):数据类型说明响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应获取设备描述文件):数据类型说明A厂商服务B家电状态设备状态查询接口见表16。表16设备状态查询接口设备状态查询请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起家电状态查询请求):说明需要查询状态的家电唯一标识码响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应家电状态查询):说明需要查询状态的家电唯一标识码00——状态汇报信息用户通过行业服务平台对其他厂商的家电进行操作。流程见图13。B家电状态B家电状态B家电状态B厂商家电B图13跨厂商平台的家电操作流程跨厂商平台的家电操作接口见表17。表17跨厂商平台的家电操作接口对家电进行操作。此操作需提供由用户登录后平台颁发的AccessToken,且仅限于用户请求参数(厂商服务平台通过行业服务平台向第三方厂商服务平台发起家电操作请求):说明需要操作的家电唯一标识码响应参数(第三方厂商服务平台通过行业服务平台向厂商服务平台响应家电操作):说明需要操作的家电唯一标识码设备厂商服务平台周期性的从设备获得状态信息，并将设备的状态态上报流程见图14。A图14跨厂商平台的家电状态上报流程家电状态上报接口见表18。/devices/deviceStat设备厂商服务平台主动向需求方平台上报家电状态信息请求参数(第三方厂商服务平台通过行业服务平台向厂商服务平台发起家电状态上报请求):数据类型说明00——状态汇报信息01——家电上下线事件通知响应参数(厂商服务平台通过行业服务平台向第三方厂商服务平台响应家电状态上报):数据类型说明AA制A务行业服务平台B务B厂商家电图15跨厂商平台的家电故障报警流程家电故障报警接口见表19。设备厂商服务平台主动向需求方平台上报家电状态信息请求参数(第三方厂商服务平台通过行业服务平台向厂商服务平台发起家电故障报警请求)数据类型说明设备报警信息数据，见GB/T36428响应参数(厂商服务平台通过行业服务平台向第三方厂商服务平台响应家电故障报警):数据类型说明绑定授权关系等信息应在不同的平台中保持同步。一旦有用户和设备信息的和用户唯一标识码(UUserID)的映射表，还应在各服信息同步服务行业平台侧接口见表20。信息同步服务行业平台侧接口设备厂商服务平台主动向需求平台上报同步信息请求参数(设备厂商服务平台通过行业服务平台向其他厂商服务平台发起信息同步请求):数据类型说明响应参数(厂商服务平台通过行业服务平台向第三方厂商服务平台响应信息同步):数据类型说明则行业服务平台通过向编码解析平台发送编码查询请求获取该编图16。表21编码解析接口请求参数(厂商服务平台向行业服务平台发送编码解析的请求):数据类型说明需解析的编码响应参数(行业服务平台向厂商服务平台响应编码解析的结果):数据类型说明返回值中文说明RetCode(十进制)返回值英文说明1234567Userregistrationfai89ApplicationuninstallfailedEncryptionprotocolnegoiationf时间戳不在有效范围内UPlatformregistrationfaiUUserregistrationfaiThird-partyuserregistrationfCancellationfailed,third-partUUserpasswordmodificationfaiDeleteusertofamily表22(续)返回值中文说明RetCode(十进制)返