GB_T 43960-2024 云制造服务平台开放接口要求.docx
ICS35.240.50CCSJ07中华人民共和国国家标准GB/T439602024云制造服务平台开放接口要求Openapplicationprograminterfacerequirementsforcloudmanufacturingserviceplatform2024-04-25发布2024-11-01实施国家市场监督管理总局国家标准化管理委员会目次前言III1范围12规范性引用文件13术语和定义14缩略语15开放接口模型26接口类型37接口编写要求98接口设计要求1()9接口注册与调用要求1010数据包格式Il附录A(资料性)云制造服务平台开放接口示例13本文件按照GB/T1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国机械工业联合会提出。本文件由全国自动化系统与集成标准化技术委员会(SAGTC159)归口。本文件起草单位:北京航大智造科技发展有限公司、江苏省工业互联网发展研究中心、贵州航大云网科技有限公司、苏州申浪信息科技有限公司、北京机械工业自动化研究所有限公司、清华大学、贵州大学、北京航空航天大学、贵州溪山科技有限公司、中科云谷科技有限公司、中国科学院自动化研究所、重庆大学、江苏中车数字科技有限公司、南京航空航天大学、联通数字科技有限公司、广州机智云物联网科技有限公司、贵州鸿巨热力(集团)有限责任公司、北京工业大学、贵州中车绿色环保有限公司、航天精工股份有限公司、北京科技成果转化服务中心、河北宝力工程装备股份有限公司、湖南华博信息技术有限公司、国家开放大学、浪潮通信技术有限公司、浙江第元信息技术有限公司、四川德恩云智造科技有限公司、云智(天津)科技有限公司、北京信达远科技有限公司。本文件主要起草人:杨灵运、张华、于文涛、王海丹、曹玉龙、谷牧、赵千川、杨静、冯泽军、任磊、尹作重、张昌福、杨文峰、周志忠、唐敦兵、孙洁§、姜海森、石伟、王发华、陈世超、李孝斌、黄灼、邢雁、吕宜生、曲涛、景宁、许培炎、王琢璞、金F凡、冯濒元、周恢、朱海华、张泽群、薛舒允、潘明波、杨杰、石娇、严海蓉、刘希亮、宿春慧、王旭亮、王紫程、胡丙齐、龚博翔、石永、甄伟、罗向阳、赵建林、田志、袁卓异、陈海锋、谢龙德、陆小斌、王洪臻。云制造服务平台开放接口要求1范围本文件规定了云制造服务平台的开放性应用程序编程接口模型、接口类型与设计编写要求,为云制造服务平台的开发者提供指导。本文件适用于指导云制造服务平台的制造资源/能力接入、微服务/APP应用开发有关接口的开发、调用与测试。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T298262013云制造术语GB/T39471-2020云制造服务平台制造资源接入集成规范GB/T39403-2020云制造服务平台安全防护管理要求3术语和定义GB/T29826-2013界定的以及下列术语和定义适用于本文件。3.1开放接口openapplicationprograminterface云制造服务平台对外提供的开放性应用程序编程接口。3.2工业应用服务接口applicationprograminterfaceforindustrialapplication在云制造服务平台上,提供的支持工业应用开发和管理等方面的开放性应用程序编程接口。3.3制造资源/能力½j口applicaticnprograminterfacefornmifacturingresource/CaPabilityi11prt在云制造服务平台上,为云制造资源/能力接入到平台,提供的支持数据传输、资源管理、标识管理等方面的开放性应用程序编程接口。4缩略语下列缩略语适用于本文件。API:应用程序编程接口(APPIiCalionProgrammingInterface)APP:应用程序(APPHCatiOn)ERP:企业资源计划(EnterPriSeResourcePlanning)HTTP:超文本传输协议(HyPerTeXtTransferProtocol)HTTPS:超文本传输安全协议(HyPerteXtTransferProtocolSecure)ID:身份标识号(IdentifiCatiOn)MES:生产制造过程执行系统(ManUfaCtUringExecutionSystem)OWASP:开放式Web应用程序安全项目(OPenWebApplicationSecurityProject)P1.M:产品生命周期管理(ProdUCl1.ifecycleManagement)POST:HTTP协议的POST方法(PoSI)PUT:HTTP协议的PUT方法(PUt)S1.A:服务等级协议(SerViCe-1.eVelAgreement)SCADA:数据采集与监视控制系统(SUPerViSoryControlAndDataAcquisition)5开放接口模型5.1通则云制造服务平台开放接口模型架构见图1,包括工业应用服务接口和制造资源/能力接入接口两大类开放接口。制造资源/能力接入方面应符合GB/T394712020第6章第8章的规定。接口安全方面应符合OWASP、GB/T394032020的相关规定。两大类接口可使用HTTP、HTTPS等传输协议,宜遵守OPenAPlSpecificationS1.A等规范。5.2应用服务接口工业应用服务接口分为工业应用开发接口和工业应用管理接口,其中工业应用开发接口包括数据类接口、模型类接口和微服务类接口,应明确工业应用开发调用的数据、模型和微服务的接口;工业应用管理接口应包括应用管理类接口和安全类接口,应提供应用部署、监控管理、身份认证、访问控制、权限管理等方面的接口。5.3制造资源/能力接入接口制造资源/能力接入接口分为制造资源/能力接入服务接口和制造资源/能力接入管理接口,其中制造资源/能力接入服务接口应包括设备数据类接口、设备控制类接口、系统数据类接口和接入安全类接口,应明确工业设备、企业信息系统与平台数据交互、设备控制命令下发和保障接入安全的接口;制造资源/能力接入管理接口应包括设备管理类接口、边缘管理类接口和标识类接口,提供工业设备、边缘网关等云制造资源管理和标识等方面的接口。6接口类型6.1云制造服务平台开放接口主要有以下几种类型:a)数据类;b)模型类;c)微服务类;(1)安全类;e)标识类;f)管理类;g)控制类。云制造服务平台开放接口示例参见附录A。6.2 工业应用服务接口6.2.1 雌口6.21.1 数据获礴数据获取接口应支持数据资源状态信息查询,典型接口定义见表1。表1数据获取接口定义接口名称数据获取接口接口说明根据企业和数据资源ID,获取数据资源的状态信息接口方法POST参数说明至少包含:数据资源ID(String(IataRID)%企业ID(StringentlD)>用户ID(StringuserID)、身份认证参数(Stringaccess-token)返回值返回所需要的数据资源信息,例如数据量、数据更新时间、数据权限等6.21.2 数据分析接口表2数据分析接口定义接口名称数据分析接口接口说明根据数据分析任务和用户ID获取数据分析结果接口方法POST参数说明至少包含:企业ID(StringentID)、用户ID(StringUSerID)、身份认证参数(StringaCCeSS_token)、数据分析任务ID(StringdatID)返回值返回数据分析结果信息6.2.2模型类接口6.2.2.1 模型注册接口模型注册接口应能支持不同类型模型在平台上实现注册的功能,典型接口定义见表3。«3模型注册接口定义接口名称模型注册接口接口说明获取新增模型注册信息接口方法POST参数说明至少包含:用户ID(StringUSerID)、身份认证参数(Stringaecess_token)、模型名称(stringmo-deName)、模型描述(SlringInOdeDeS)、模型分类(StringmodeClass)返回值返回包含是否注册成功6.2.2.2 模型状态查询接口模型状态查询接口应能支持不同类型模型在平台上的运行状态查询等功能,典型接口定义见表4。*4模型状态查询接口定义接口名称模型状态查询接口接口说明获取模型运行状态数据接口方法GET参数说明至少包含:用户ID(StringUSerID)、身份认证参数(StringaCCeSSJoker1)、模型ID(StringmOdeID)返回值返回所需模型运行状态数据6.2.3 微服务类接口6.2.3.1 微服务注册接口表5微服务注册接口定义接口名称微服务注册接口接口说明获取新增微服务定义信息接口方法POST参数说明至少包含:用户ID(SlringuserID)身份认证参数(Slringaccesstoken)微服务名称(SIringSeVName)、微服务描述(StringSeVDes)、数据中心地址(StringdataUrl)返回值返回所需微服务信息数据6.2.3.2 微服务查询接口微服务查询接口应能实现平台微服务的运行状态查询,典型接口定义见表6。表6微服务状态查询接口定义接口名称微服务状态查询接口接口说明获取微服务运行状态数据接口方法GET参数说明至少包含:用户ID(StringuserID),身份认证参数(StringaCCCSS_tokcn)、微服务ID(Stringmi-CroSerID)、任务ID(StringtaskID),启动微服务的用户账号(StringuserName)返回值返回所需微服务运行状态数据6.2.4 应用管理类接口6.2.4.1 应用部署发布接口应用部署发布接口应支持创建和发布应用,典型接口定义见表7。«7应用部发布接口定义接口名称应用部署发布接口接口说明创建和发布相关应用接口方法POST参数说明至少包含:用户ID(StringUSer1D)、身份认证参数(StringaCCeSS_token)、应用ID(StringappID)¼应用名称(StringappNamc)、应用版本(StringappVision)返回值返回包含应用ID和是否发布成功状态值6.2.4.2 应用健康状态监测接口表8应用健康状态监测接口定义接口名称应用健康状态监测接口接口说明获取应用的健康状态等数据信息接口方法GET参数说明至少包含:用户ID(SlringuserID)>身份认证参数(Stringaccesstoken)、应用ID(SIringapplD)返回值返回应用是否正常运行的状态信息6.25 蹒鞋雌口应用安全类接口应支持应用管理用户身份认证、获取访问权限等功能,典型接口定义见表9。表9应用安全认证接口定义接口名称应用安全认证接口接口说明根据用户的身份认证获取应用的访问权限接口方法GET参数说明至少包含:用户ID(SIringuserID)>身份认证参数(Stringaccesstoken)、应用ID(SIringapplD)返回值返回应用的授权状态值6.26 造资源/能力接入接口6.26.1 备数据类接口6.26.1.1 备状态接口设备状态接口应能实现查询设备状态功能,包含运行、待机、故障、离线四种状态,典型接口定义见表10。表10设备状态接口定义接口名称设备状态接口接口说明查询设备当前状态接口方法GET参数说明至少包含:用户ID(StringuserID)、身份认证参数(StringaCcess_tOken)、设备ID(StTingdevID)返回值返回包含是否成功63.1.2设备数据接口设备数据接应能实现设备运行数据采集功能,获取数据点列表,典型接口定义见表11。«11设备数据接口定义接口名称设备数据接口接口说明设备运行数据采集接口方法POST参数说明至少包含:用户ID(SlringuserID)、身份认证参数(Stringaccesstoken),网关ID(Slringgate-谭ID)、设备ID(StringdevID)数据键值对(StringdevVar)返回值返回包含是否成功1.3.2 设备控制类接口设备控制接口应能实现设备控制命令下发等功能,典型接口定义见表12。表12设备控制接口定义接口名称设备控制接口接口说明设备控制命令下发等接口方法POST参数说明至少包含:用户ID(StringUSer1D)、身份认证参数(StringaCcess_token)、设备ID(StringdevID)»指令内容(Stringmessage)返回值返回包含是否发送成功和执行结果1.3.3 系统数据类接口系统数据类接口应能够支持企业信息系统接入,实现云制造服务平台与接入的信息系统之间数据传输。系统数据类接口应包含ERP、P1.M、MES等信息系统与平台进行交互的接口,典型接口定义见表13。«13生产物料表单保存接口定义接口名称生产物料表单保存接口接口说明平台保存信息系统中生产物料表单信息接口方法POST参数说明至少包含:用户ID(StringUSerID)、身份认证参数(StringaCcess_token)、表单名称(stringMatc-rialName)返回值返回包含是否成功1.3.4 接入安全类接口接入安全类接口用于对接入资源的身份进行鉴权,包括设备安全认证接口等,典型接口定义见表14。*14设备安全认证接口定义接口名称设备安全认证接口接口说明对设备身份进行鉴权接口方法POST参数说明至少包含:用户ID(StringUSer1D)、身份认证参数(StringaCcess_tokcn)、设备ID(StringdevID)设备证书(StringdcvSign)返回值返回包含是否认证成功1.3.5 设备管理类接口设备管理类接口应能够实现设备的创建、查询、分组、编辑、删除、导入、导出和设备模板管理等功能,典型接口定义见表15。表15设备查询接口定义接口名称设备查询接口接口说明获取设备信息接口方法GET参数说明至少包含:用户ID(SlringuserID)>身份认证参数(Stringaccesstoken)、设备ID(SIringdevID)返回值返回包含是否成功1.3.6 边缘管理类接口边缘管理类接口应能够实现边缘网关管理、云边协同节点管理、边缘应用管理等功能,典型接口定义见表16,«16边缘网关创建接口定义接口名称边缘网关创建接口接口说明创建边缘网关,存储网关信息接口方法POST参数说明至少包含:用户ID(StringuserID)、身份认证参数(StringaCCeSSJoken)、网关名称(stringgate-WNamc)、通信协议编码(StringCommCodc)、通信协议地址(StringCOmInir1)、网关类型编码(stringiotTypc)返回值返回包含是否成功6. 3.7标识类接口7. 3.7.1设备标识保存接口设备标识保存接口应能够实现获取设备唯一标识编码的功能,典型接口定义见表17。表17设备标识保存接口定义接口名称设备标识保存接11接口说明获取设备唯标识接口方法POST参数说明至少包含:用户ID(stringuserID)、身份认证参数(StringaCcessjokcn)、设备ID(StringdevID)>标识分类ID(StringClassifyID)标识模板版本(StringIeinplateVersion)标识模板属性(StringIemplateAttribute)返回值返回包含是否成功6.3.7.2网关标识保存接口网关标识保存接口应能够实现获取网关唯一标识编码的功能,典型接口定义见表18。表18网关标识保存接口定义接口名称网关标识保存接口接口说明获取网关唯一标识接口方法POST参数说明至少包含:用户ID(StringUSerID)、身份认证参数(StringaCCeSS_token)、网关IDStringgate-WID)、标识分类ID(StringCIaSSifyID)、标识模板版本(StringtempiateVersion)标识模板属性(stringtemplatettribute)返回值返回包含是否成功7接口编写要求7.1 实用性接口符合以下实用性要求:a)数据格式:应使用支持跨平台、通用性的文件格式,例如JSON、PrOtoBUf等,也可采用XM1.、TXT作为程序开发辅助;b)数据量:按需分配。7.2 易用性接口符合以下易用性要求:a)接口、参数命名准确:接口及参数应包含必要内容,易于理解;b)接口数据、状态:对于传输成功/失败的情况,接口应提供明确的数据状态信息及返回值;c)接口可扩展性:接口应具备可扩展性,可支持功能调整或者扩展。7.3 安全性接口符合以下安全性要求:a)接口安全:应使用约定的算法,对传递的参数值进行验证匹配;b)加密规范:在传递用户名密码时,应采用规范的加密算法,进行数据通信请求,推荐使用国产加密算法;c)接口版本控制:应对接口进行版本控制,平台及软硬件升级时更新接口版本,宜定期处理新、旧版本接口的状态。8接口设计要求8.1 一般要求接口设计应尽量减少参数传递,按请求情况进行传递。接口设计应尽量避免接口重复性,提高接口复用性,减少HTTP请求,提高程序稳定性。8.2 数据类型规范设计接口时,应标注参数数据类型,以及是否可为空或者默认字段,设计参数数据类型应与对应返回数据类型一致,参数字段不匹配容易造成应用程序出现数据类型解析异常。8.3 编码规范接口开发过程中,应标注接口编码方式,宜采用UTF-8编码。8.4 请求方式编写接口时应标注请求方式,一般有GET、POST、PUT和DE1.ETE等方式。在数量较小情况下使用GET方式,数据量超过1024字节时应采用PoST方式,避免出现请求失败或者请求异常的问题。8.5 返回接口调用状态所有接口都应使用统一的调用成功/失败标识信息和错误编码信息,以及必要的提示字段信息。8.6 St11J设计接口应使用验证签名机制,可支持接口安全验证。8.7 #»啊接口应标注参数名称、是否必选、数据类型及范围,以及说明“是/否”传递默认的参数。9接口注册与调用要求推荐使用HTTPS协议,使用POST和PUT方式提交数据。接口定义遵循RFCl945(HTTPl.0)、RFC2616(HTTPI.1).RFCO959(FTP)、RFCI866(HTM1.)或RFC4627(JSON)<.接口调用应进行身份核实和权限校验,同时应记录接口调用信息,可正确解析接口调用的反馈结果。10数据包格式10.11.1.1 1公共分数接口公共参数如表19所示。可采用应用授权认证接口方式。表19公共弁数参数名类型是否必需描述apikeystring是用户注册时分配到访问服务所用的密钥Timestampstring是请求的时间戳。日期格式按照ISO8601标准表示,应使用UTC时间formatstring否返回值格式,支持XM1.或JSON,默认为JSONencodingstring否接口调用请求包的编码类型,支持UTF-8和GBK,默认为UTF-8bodysigstring是参数签名,应实现body_sig外所有参数串的签名,包括业务级的参数1.1.2 2业务参数的通用约定接口业务参数的通用约定如表20所示。«20业务分数参数名类型描述page_noint用于支持分页的API,表示第几页,默认为1page_sizeint用于支持分页的API,表示每页返回多少条数据,默认以及上限为25device_typeint终端类型10.2 错误响应输出格式错误响应输出内容应符合以下规范:返回内容应由errojcode,eojmsg2个属性组成,分别用于描述错误码和错误信息。10.3 错误码定义接口调用过程中可返回的错误码定义如表21所示。«21错误码定义ErrorCodeErrorMsgDescription200Success成功100100Error接口调用失败100lOlObtainACCESS_TOKENfailedACCESS.ToKEN获取失败100102Necessaryparametermissing缺少必要参数100103Invalidconditionalinformation无满足条件信息100201Invalidaccesskey访问密钥不匹配100202InvalidACCESSTOKENACCESS_TOKEN已过期或不存在100203Permissiondeny无调用权限100301Userinformationparameterincorrect用户信息参数有误100302PPinformationparameterincorrectAPP信息参数有误100404NotFound无法找到请求资源100501P1unavailableAPl不可用100502Inputparameterincorrect输入参数有误或不存在100505Pathparameterincorrect路径参数有误100507Inputparametermissing缺少输入参数附录A(资料性)云制造服务平台开放接口示例A.1工业应用服务接口示例A.1.1数据获取接口示例A.1.1.1数据获取接口调用传参示例数据获取接口调用传参的格式示例如下:“entld":"438362206774265856”,“userid":"438362794917922816,"access-token,'"fO44R6tOWxh3wrTIkWP01,"data,'4ndataRId"r',496"A.1.1.2数据获取接口调用返回示例调用成功返回示例如下:"status":200,"datasize":"965M",“updatetime":"1491448161000”,"datarighets"',aI'调用失败返回示例如下:("status'1:100502,"msg":"Inputparameterincorrect"A.1.2模型注册接口示例A.1.2.1模型注册接口调用传介示例模型注册调用传参的格式示例如下:"userid":"438362794917922816”,uaccess-token"f,fO44R6tOWxh3wrTIkWP0",data""modeName":"工业机器人减速器故障诊断模型,,modeDes":"该模型可对机器人减速器进行故障检测,主要采用了决策树模型,返回预测结果,"modeClass":"故障诊断”)A.1.2.2模型注册接口调用返回示例调用成功返回示例如下:"status',200,"msg":"Success"调用失败返回示例如下:,status":100102,msg":"Necessaryparametermissing"A.1.3微服务注册接口示例A.1.3.1微服务注册接口调用传弁示例微服务注册接口调用传参的格式示例如下:"userid”<438362794917922816”,access-token",fO44R6tOWxh3wrTIkWP0",data",sevName"设备接入静态数据查询服务,,sevDes":"提供大量的基于设备接入静态数据的查询分析接口,例如:设备FI增加数量统计、企业设备数量统计查询、设备省份分布查询接口服务等,',dataUrl,"http:/172.16.18.71/")A.1.3.2微服务注册接口调用返回示例调用成功返回示例如下:,status'200,"msg":"SUCCeSs"调用失败返回示例如下:("status11:100507,"msg":"Inputparametermissing"A.1.4应用部署发布接口示例A.1.4.1应用部署发布接口调用传介示例应用部署发布接口调用传参的格式示例如下:(“userid":"438362794917922816,"access_token":"fO44R6tOWxh3wrTIkWPO","data":"appID":"3145256”,"appName,"TPM""appVision,"V13"A.1.4.2应用部署发布接口调用返回示例调用成功返回示例如下:("status":200,"msg"/'Success*'调用失败返回示例如下:("status":100302,"msg":"APPinformationparameterincorrect"A.1.5应用安全认证接口示例A.1.5.1应用安全认证接口调用传介示例应用安全认证接口调用传参的格式示例如下:(“userid":"438362794917922816,"access-token,f,fO44R6tOWxh3wrTIkWP0","data":"appID":"3145256”A.1.5.2应用安全认证接口调用返回示例调用成功返回示例如下:"status":200,"msg":"A1.1."调用失败返回示例如下:,'status":!00301,"msg":"UserinformationparameterincorrectA.2制造资源/能力接入接口示例A.2.1设备状态接口示例A.2.1.1设备状态接口调用传弁示例设备状态接口调用传参的格式示例如下:"userid":"438362794917922816”,"access_token":"fO44R6tOWxh3wrTIkWP0",ndata":"devld":"82295865259”,A.2.1.2设备状态接口调用返回示例调用成功返回示例如下:"status":200,“msg":"Success","devStatus'':"开机",调用失败返回示例如下:',status":100100,',msg"r"Error"A.2.2设备控制接口示例A.2.2.1设备控制接口调用传介示例设备控制接口调用传参的格式示例如下:"userid":"438362794917922816”,"accessJoken,"fO44R6tOWxh3wrTIkWP0','data,"devld":"82295865259”,"message:"1"A.2.2.2设备控制接口调用返回示例调用成功返回示例如下:("status":200,"msg":"success'"result":"r调用失败返回示例如下:("status":100202,"msg,z,InvalidACCESS_TOKEN"A.2.3生产物料表单保存接口示例A.2.3.1生产物料表单保存接口调用传弁示例生产物料表单保存接口调用传参的格式示例如下:“userid":"438362794917922816”,"access-token"f,fO44R6tOWxh3wrTIkWPO,"data,U"MaterialName":"identity_zone"A.2.3.2生产物料表单保存接口调用返回示例调用成功返回示例如下:("status":200,"msg":"success"调用失败返回示例如下:"status":100100,"msg"f,Error"A.2.4设备安全认证接口示例A.2.4.1设备安全认证接口调用传参示例设备安全认证接口调用传参的格式示例如下:“userid":"438362794917922816”,"access_token":"fO44R6tOWxh3wrTIkVPo","data":devld:“6565818958”,"devSign":"02357.PDF"A.2.4.2设备安全认证接口调用返回示例调用成功返回示例如下:"status":200,"msgH:"success"调用失败返回示例如下:"StatusnJOOlOO,"msg":"Error"A.2.5设备查询接口示例A.2.5.1设备查询接口调用传介示例设备/产品查询接口调用传参的格式示例如下:“userid":"438362794917922816,"access_token":"fO44R6tOWxh3wrTIkWP0","data":"devid":"285863325"A.2.5.2设备查询接口调用返回示例"status":200,"msg":"success""devName":"华数机器人”,"devGroup":nl#产线”,"devAdd":"中国北京市石景山区航天云网大厦”调用失败返回示例如下:"status":100100"msg"f,Error"A.2.6边缘网关创建接口示例A.2.6.1边缘网关创建接口调用传参示例边缘网关创建接口调用传参的格式示例如下:“userid":"438362794917922816,"access.token"f,fO44R6tOWxh3wrTIkWP0',data,z"gatewName":n数据采集网关","commCode""70'"commUr"MQTT",'iotType""70'A.2.6.2边缘网关创建接口调用返回示例调用成功返回示例如下:("s(alus":200,"msg":"SUCCeSs”调用失败返回示例如下:("status,l00100,"msg":"Error"A.2.7设备标识保存接口示例A.2.7.1设备标识保存接口调用传介示例“userid":"438362794917922816,"access.token",fO44R6tOWxh3wrTIkWP0","data,'4“devld":"82826642265”,"templateVersion":*'工业设备”,"templateAttribute","data":("format":"SEng”,"value":"工业机器人),index""2000,rtype"deviceName"A.2.7.2设备标识保存接口调用返回示例调用成功返回示例如下:"statusH:200,"msg":"success"调用失败返回示例如下:nStatusnIlOOlOO,"msg"f,Error,