《餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准》.docx
餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准目次2餐饮用户燃气报警控制系统远程监控装置4通讯协议及平台接口标准41范困42Me范性引用文件43术语和定义431IoT通讯平台43.2 物账网报警器43.3 3NBiSrfr43.4 4G设备S4数据要求54.1 数据类型54.2 数据传蛤约定S5编码规则55.1 帧格式55.2 控制码65.3 设备端码65.4 校验75.5 帧序号85.6 数据区86命令详情86.1 M络参数86.2 上报冏期96.3 报警门限定96.4 主动上传106.5 tcp注册116.6 tcp心跳126.7 状态类型表137数据交换内容137.1 基本数据137.1.1 点位信息137.1.2 设备信里137.1.3 预警信息137.1.4 实时采集记录137.2 信息实体137.3 .1点位信息137.4 .2设备信息147.5 .3预警信兑167.6 .4实时采集记录167.7 2.5数据字典168平台接口格式要求197.8 1接口分类198.2 接口格式198.3 HTTP状态码209平台接口信息219.1 监测点位新增219.2 监测点位编辑219.3 监测点位蒯除219.4 设备新增229.5 设备端¥t229.6 设备删除229.7 设备实时采集239.8 设备预警采集239.9 便警处置23餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准1葩围本标准规定了燃气温漏报瞥器的相关术语、符号和缩珞语定义:也规定了NB-IoT、5G,4G、3G、2G等终端设备的通信协议和通信加密要求:还规定了终端设备的编码规则及设备的接入要求.本标准适用于独立式燃气泄漏报警潜和可燃气体报警控制器的4(;、W-IoT等智能通信功能实现.以及报警器平台的终端设法系统接入,.本通讯协议支持、B-1.oT、5G、4G等物联网通讯协议。2规葩性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注口期的引用文件,仅该日期对应的版本适用干本文件:不注H期的引用文件.其最新版本(包括所有的蜷改单)适用于本标准.GB.T17964-20«)估息技术安全技术n位块密码算法的操作方式GB/T222392OO8信息安全技术信息系统安全等级保护狼本要求GB15322.1-2019可燃气体探测器第1部分:工业及商业用途点型可燃气体探测器基于窄帚物联网(NB-IoT)技术的燃气智能效衣系统(中国城市燃气协会发布,GB15322.2-2019可燃气体探测器第2部分:家用可燃气体探测器GB16808-2008可燃气体报警控制器3术语和定义下列术语和定义适用于本文件,3.1 IoT通讯平台IOT通讯平台称主站,是采用蜂窝移动通信(含2G、3G、4G、NB-IoT)方式完成对报警器的数据采集、传输、控制.3.2 物联网报警需以传尊潺为基础,加装电子控制电路.具有数据采集、存储等功能,并采用物联网通信技术进行数据传输的报警器.3.3 NB设备NB1.oT终端设备的简林,特指果用NBToT技术,可直接与主站系统互联的终端设备.NB设备指采用BTuT接口通讯的居气泄漏报答器.3.4 4G设备4G终战设茶的筒称,特指采用4G通讯技术,可直接与主站系统互联的终战设备,.4G设备包含独立式燃气泄漏报警器和可燃气体报警控制器,4数据要求4.1 数据类型悔议描述中纯数字均为IO进制,以OdF头均为16进制,选靖数据必须占位,占位符OXO0短整型:2字节小箍对齐,低字节在前整型:1字节,小然对齐,低字节在前浮点数:4字节,IEEE754标准ASCI1.码:高字节在前BCDH:高字节在前4.2 数据传输约定一次完整的通讯过程有以下三种情况触发:第一种情况,达到设定上报周期时间时触发,报警器自动上报数据:第二种情况,发现实时报警时触发,报警器上报报警信息:第三种情况,现场人城长按键5杪触发,报警器临时性上报数据。发送指令30杪后未收到回复指令,判定为通讯超时,需重新发送,重发次数不超过3次,连续3次发送超时,判定为失败.5编码规则5.1帧格式帧格式见表I.表1帧格式说明域名称长度说明帕夫I(HEX)0x68像长度2(HEX)从协议版本号到i据域数据的字节长协仪版本号I(HEX)(1x20:表示2.0版本,此出议版本为2。密的版本号I(HEX)OX1.O:表示1.Ote的版本.我队地址8(BCD)小琳模式,拉制戕地址,独立式报警格为报警热地址.控制码I(HEX)命令码2(HEX)帕序号2(HEX)从OXoooI开始计算.Kinf1.OXFFFF后从OX(XKn*新开始iftk,序号用F多赖兹搦传输校验.其它帧固定壤1.数据域N(HEX)数据域加密时.如我原始数据K改为0.嫄霜川充16字节,长度为C1.XIe1,CRC1.62(HEX)CRC16,从超始符至数据域的结束(需要加密处理的需先进行加密处理,再计尊校的码)络央符1(HEX)0x165.2控制码控制码见表2。表2控制码说明位定义位01备注传箱方向BO下行上行是否加密B1.不加密加密是否结束帔B2未结束结束是否需要应答H3无需应答洸要应答发起标志B1.命令发起端命令应答瑞读写标志B5读命令”命令配置命令有效B6-7保田下行:指主站向终端设备发送数据:上行:指终端设备向主站发送数据:对要求加谢的命令数据,如果按明文发送,应判定该数据无效,对数据域需要加密的命令帧,在发送命令时需先时数据域加密,再计算校验码。报警器接收到命令帧后,需先判断校5金码是否正确.如果校腕不合格,为无效命令顿.如果校验码正确后再解定.解密数据后需要首先根据数据地充规则(数据末端必须至少彳i0x80,如果0x80后面还有数据必须为OXoO)判断数据加密的有效性,通过后再根据协议解析数据格式是否符合要求.5.3设备编码设品编码规则定义见农3。通信数据流与实际设备编码顺序对应,当实际设备编码不足8字节时,在高端补零。表3设备编码规则定义数据内容说明厂宓代码1字节各设备厂商根据“厂家代码妁定”填写设备类里】字初)I一工商业报警器2一交用报警器生产年月(2字节生产序列号(4字节)厂家代码约定说明,*代后分M由对撞人处狡一分配管理厂*代码厂家10H12131.1.5.4校验校验的算法为:从起始符开始,到数据区结束,所有字节的CRCI6校胎.CRCI6:多式采用CCIT:X1.t+X"+X/CRCtypeddf1.CRC-TYP三CCIT*d÷11nesc二TYP1.cXBM/Po1.ynomia1.×*16×12×a51#”Wpo1.yx<*iiA1._ccx?/Po1.ynomia1.-X*1.«Xa15X219dcfi11cPo1.yxcmia1._iEM/5*÷<3adefineCRC-IEM-SDVdQfinoCRCCCXTTSEED*CRCa1.goritNnuip1.omentaticn*arawIX1.crcPreviousCRCva1.w?par!IN<1.ataNewdatatoZaddedtotheCRCPO1.yncm1.A1.CRCpo1.yrmiA1.aa1.ection(CRC-TTPK-CCIT,CRC_TYPKBM'cetva1.crcNewcc<nputedCRC/U16Coeputecrc<U16crc,udata,U16po1.ynco>1.1.>JU1/Cor(1";1<:i>J<1.t(<<<crc6>»>a<<SataS)>!)4crc«1;ehift1.eft88crc*"po1.yoxa1.;XORwithPO1.ynQCn1.oI11crc««IJshiftIoCtonce>data«*.:/Nextdatabitreturncrc;+1,种子;Ox1.DOF.OX1.O21OXBOo3OxFFFFOx1.DOFCRC16算法如卜.: CRCa1.90r1.thnrp1.»cvenatcn* parm(INItjfr«rArraycontainingthedate Xparam1.INIHfSrkngthBuffer1.ength From(INICrCTyPeSe1.ect®theCCpo1.yr41.1.CCJC.TTPBOCITT,C»C_TTPE_IBM)* Xrecva1.ctrcSuffercc<vutodCHC/U16RdiopacktcopQt4Crc<ubufCor.buffet1.enqth.CXCTyx»Y<uU16crc;U1.Cpo1.yncaniA1.;PO1.ynama1.(CCTypeCBC_7TPB_I»1)PO1.TXC*4TA1.-rBM:K>1.TWOMTA1.-,CCIT7;crc<CrCTyPe-CRC.TTFB,IBH>TCRC.IBH,SEID;EJX1.rT一8EBDCk(1"1<bufror1.«ngthr>(crcccputCrcCcrc.tjffor.po1.yncA1.a1.>1Iif(crcypcnc_rrpr_ii*<>人中<sturncrc;70r(rtun(U16)(-crc);CRCI6算法示例说明5.5帧序号帧序号从CIXo1.开始,当只有1帧时,帧序号固定为OxO1,当有多帧时,帧序号从0*01开始依次递增.每次会话的上下行帧序号须保持一致.5.6故据区根据规范,数据区数据参见命令定义.6命令详情命令列表说明见表4。表4命令列表说明命令码命令说明在注0x0102网络参数(下行)网络参数设置.0x0103上报周IWCF行)上报周期多数设置.0x0104WffniR(下行)报警门限雷数及I1.0x0301»«±»上行0x0001t卬注册(上行)tcp时需要0x02tcp心跳(上行)tcpBt33«6.1 网络叁数网络参数的要求见表5.表5网络参数名移字节长度说明网址长度1HEX表示,H火值80网址NASCI1.我东端口长r51HEX表示,Aift0,没有为。11NNSCII表示用户名长度1HEX茨示用户名长度(最大不要超过30个)没有为0用户名NASCn衣示.如:-adin*多码(接入点)长度IHEX表示,青码长收妙大不要抬过3。个).没在为0定码(接入点)NRsCu表示如.”】23456”(C1.WTM)Ar长度1HEX覆示,大值30,没在为0APNN应答的要求见我6.表6应答名称字忖长度说明返回和1DXoo-成功DX(H一影攻锚)x02一存储失败)x03-校准夫欺DX(M一校准0超出IeiBi以05其它错误预田4预招6.2 上报周期上报周期金数设定的要求见表7.表7上报周期名称字节长度说明上报周期咨数长度IHEX表示上报同期11上报周期:1HEX冷位O天,/月+1HEX次数,一时间BCDPJ(±f1.t数据起蛤时何)3HEXSm.应答的要求见表6.6.3 报警门限定报警门限设定的要求见表8.表8报警门限名称St据长度说明报警给数长度IHEX我示,必须限制用户权限IHEX表示.JftitiI-OxfeO-我示广摘地址1传感SS类型见我174HEX表示,f1.oat.报警门Rutt-1预尔应答的要求见表6。6.4 主动上传主动上传的要求见去9,表9主动上传要求名称敖姐长度说明设番类型IHEX1一工商业报警2一家川报警等原件版本号210狂字节在IihWiOx1.O,OxOO表示,0.OxFfTF表示无效软件版本号210任字节在被,例:Ox1.O,QxO。表示】.0,OXFFFF发示无效信号强22HEXYIkmRSS1.有符号Jft:例;IIOdBf1.(h(F9Z2G/3G/4G/1.7E:坨信号强度(f1.信噪比2HEXNB.SNR.有符号救。OXFFFF表示无效。信号接收功率2H£XNB:埴XSRP,<)#卜评表示无效数据条数IHKX我系数第StIi1.探头数榭1N探头数处详情见我10探头数累2NN表10探头数据名稔故M长度ttw类型说明探头地RIIEX从】开始,Et类餐依次递增.东统代报警有效,独立式出警战J*OxFF.当前采集时IBJ7BCD低位在前环位在后,无效金OXFF探头硬件版本号2BCD低字节在前,轲:0x】0,0x<X>表示1.0.无效OXFFFF探头发件版本号2BCD低字节在前,W:0x1.0,0x001.0,无效OXFFn;探头状态1IEXOKMh-正常:Hito一存砧器故状态0正常1.-iW蓝牙故Kt状态0正常1-故Bit2-与切断阀通讯状态0正常I-AtWBit3-切断阀电池状态O-jEI一欠压Bi14-时钟状态0一正常I一故田Bit5探头与控制器连接状态0正常I关联其它一预倒.阀门电池电IE111x例位V,1位小数,无效OXFF传感器数据数质IHEX传感器收据1见表11(怙辑得数据N见表11表11传感器数据性劣:检测类311IEX传然睛类型见表17传感器状志1IEXo*>-iE:OXO1.一传感斜故KhOxOZ-IttS1家用OXg-抵黑报警:工商业(Wn-海际报警:工商业OXO5"寿命报警IQxOft*H)Xf1.预用,检测位1Htaf1.oat;无效全OXFF报警门限叁数4HEKf1.oat:无效至OXFF构测单位IIEX检跳侑对应单位见表J8传感器温度4IEXf1.oat:无效金OXFFiftrt4IEXfIoa1.I无效全OXFF符用7IEX无效全DxFFO主动上报应答的要求见去12.表12应答帧的要求名称字节长度说明返回科1<1.三)以1»一成功MO1.一龄故错0x02一存储失败OXD3一校法失败OXM一校;fttfi融出而园Iw)S其它IeiR预愤4ftiiICP注册的要求见表13.表13注册包名称字节长度说明Ktifr类型no】一工Ift业报警器2家用报警JS硬件版本号2BCD低字节在的,例:Ox10,DxdO&示】.0.OXFFFF裳示无效软件版本号2BCD低字节在航,例;OXI0,0x00表示1.0.OxFFFF表示无效CCID20ASCII设备端通讯模凯的CC1.D信,若无此伶息由芹填充ffiIHEXtcp注册应答的要求地表14,表14应答帧的要求名称字节长度说明返回日I(HEX)OxOO一成功OXOI-参牧错(W)2一存储失败0x03一校准失败OXg一校猥班超出莅困005-K它精谀预田4预田6.6tcp心跳Icp心跳的要求见表15.表15心跳包名称字节K度说明信号强僮2I三XNB:堰RSS1.有符号数;例r-I1.OdBn0xFF92,2G/3G/4G/1.TE:川信号强度侑.信唾比2I<EXNB:JASNR,仃符号t.OXFm:衣示无效。信号接收功率2WEXNB:填HS腓,。仆HT表示无效预留IHHX预留tcp心跳应答的要求见表16.表16心跳应答帧的要求名称字节长度说明返回玛I(HEX)OXiw一成功DxO1.-JfftffiOXo2一存储失败OXO3一校很失败OKg一校猥班超出莅困005-K它精谟预田4H泡6.7状态类型表表17传感器类型名杉说明传想类型。:甲烷,1:氧气,2:人工作气,3:液化气,4:油IHr,5:内烷,6:己烷,7:环汉乙燎,8:硅烷.9:弧甲烷.10:乙快.U:乙饰.12:丙解,13:不乙编.14:甲醉.15:乙国,16:异丙即,17:不.18:甲末.19:二甲茉.20:丙嗣,21:iW.22:甲利23:乙队21:二甲候,25:行油做,26:乙版乙麻27:乙酸界戊格.28:汽油,29:柴油,30:可燃气体,31:航空烟油,32:四氢味喃.33:内烯祐.M:DMF.35:辄气.36:乳气.37:M气.38:一轨化碳.39:二乳化K.«0:一批化氨,41:二氧化虬12:二氧化验.43:硫化氢.M:SU匕氮.45:M化¾1.46:Bi化S1.47;软化S1.48:配合气,45温度.501压力表18单位含义名称说明浓位1:UE1.2:VO1.3;PPM,4;uno1.n<>,5;ngm3,6:%RH.7ns.9:km/h.10:1.X.IhPa.12>DB.131m3:ro»8;7数据交换内容7.1 基本数据7.1.1点位信息映射到地图上到具体的位置,同一个监测点位下可以绑定多个燃气泄漏报警器设备,不同的监测点位以监测点位编码区分.7.1.2设备信息燃气泄漏报警器设备信息.7.1.3预警信息燃气泄漏报警器设备上报的预警信息.7.1.4实时采集记录燃气泄涮报警器设法上报的实时枭集记录.7.2 信息实体7.2.1点位信息字段字段名称字段类型字段说明dc<ain1.dWID数字B1.定分配orjjCode现织编码文本固定分配orsNa>?俎织名卷文本固定分配govcrCodeIfftfJSR文本行市区街道4线地址,俄码参号国*行政区划编码,保尔12位长度gover11e行政名称攵本省市区街道nonit<>rC<×1.c点位.编玛文本点位唯一标识11onit<>rypcKi测类别敷字固定位:oo(用气期同>(Itjni1.orSubType点位英里数字数处字典:IO1.nuniIorXaite点位名称文本根据居民和非居情况非居点位输入店招名称例如:建华饭店'叫了只炸马(i1.K11A>.居尺点位怆入用户联系人,例如:黄永曲address定位地址文本移干SS地图的定位地址detoi!Address详细地址文本n体位置信息,包括街道门牌号等,例如i厦门市湖里区金山西里12730hSa浮点火星坐标系GCJ4)2Iat纬度浮点火星坐标系GCJ-O2IinkVkm联系人文本该监测点位的联系人姓g,Wft1.李冰心iIinkPhone联治电话文本透联系人的手机号(11位手机号),发生告警时公发送短信通MI到读手机号.例b13688011734,gasTye燃气种类数字妆如字典:U8gesSuPP1.igr供气企业数字数据字典:119srType用户种类数字数据字典:120industry所行业数字数据字典i12】property所S1.物业文本具体的物业公司rorr1.y1.xhonc物业电话文本物业公司电话note*注文本7.2.2设备信息字段字段名妆字段类型字段说明dowin1.d域ID数字因定分配orgCod<姐妲编码文本固定分配OrgNwne期织名林文本囿定分配goverCode行政编码文本省市区街道4媛地址,於码参号国亲行政区划编码,保8112<长度gover>ne行改名林文本省市区街道devCode设备螭耳文本厂家设各上的唯一识别号,东统会以该号进行Ji据采卷对应t果存在多个探头的情况下.设备编9后搔标注"-K-2"M1.:81108222206-k8108222206-2dcvNa>c设缶名梆文本我认填写京位名称,如果存在多个探头的情况下,点位名称后假标注-1.2"WJ>建华饭店T、建华饭店-2devType整备类型数字冏定ft1.h1Q2<X>2(过气JttiK报警戡)11nniIOrCOdt*总位输和文本所碱点位唯一标做ndcirrss;定位地址文本堪于GIS地图的定位堆比Factory设备厂*数字数据字典:116nodeI设备皇号数字数据字典:11?ranufacture1.>ate出厂日期文本如:2022-11-11Va1.idPeriod有效冏期数字传灯!8有效期年限.比h3年1.ocation安装位贸文本ffiF国用吊顶.瞄阴.储笳室,储植间.浴条,阳台.过道.户外、热水;a旁、厂房内、操作间,车间.H:(IaIrHenan<re<<)(ipany港保单位文本件后欣系加使nainienaceMan泡卬瓦系人文本竹后款祭人11aint!mancr1.*honc然保电话文本售后我系电话Ing经度浮点火星坐标系GCJT>2)Iat纬度浮点火里坐标系GCJY2)SvitchVa1.ve«否有切故字设的是否苗有切厮阀.是I1.否I0断用note占注文本7.2.3预警信息字段字段名称字段类型字段说明Ckgin1.d域ID数字01定分配VamingId预警H)文本预警唯一标识devCoder!ta文本电符信息中的设翁编号VamineType预警类至数字数据字典r1。3vamin1girtr预警时间时何设备产生预警的时阿upIoadTis?上报时何时何系统接收到收警的时何datnCode预警监测切玛文本Jf1.警指标晶码,如:CHhCSH8,OMfdataJaftt?饯警监测名杉文本KI警指标名称,如:甲烷.丙烧.一瓶化碳等dataV'a1.ue预警监测值文本Ki警的值dataUnit预警催测地位文本预警指标对应的的位7.2.4实时采集记录字段字段名称字段类型字段说明donin1.dWID数字ISI定分配devCode设各城号文本设备信息中的设备独号devStatus设备状态数字设备采集时的状态,数据字典I112Up1.oadTime上报时间时间系统收到呆集数据的时间up1.oadInfo上报惮情文本设各采蜒的折标数据,J。SN时象致01格式,摊一个时较需包括dataC<xk(采集指标泊码).dat5ane(果典IS标名称)、dataV.1.ue(果黑指标也、dau1.1.nit(采集指标单位四个M性。7.2.5数据字典g称始码参照他监测类型100OO1.用气监测点位类X!IO1.OO1.居民点位类51101002政府点位类X!101003学校点位类型IO1.OOI医院点位类型!010(>5商业点位类型101006工业点位类型101007酒店点位类蟹101008孝国其他设缶类型102002生气泄*i报警器预警类X!103008燃气泄然预警类51103023i51¾tSBW类5!103024燃气超低很浓度刑警类型103025耨气招AiBJ浓度预警类型103026寿命告警预警类型103027一巩化碳泄漏Jft警类型103028传侬丽预警类中103029存储拈故障预警类叁103030切新阀通讯故碎预警类空103031切断阀电池植外预警类51103032报警据故障BW类5!103033IS牙故4用气性质107001居民用气性JeKKo盟拿居设备状态1120()!正常设备状态112002使警设备状态112003故障设品状K1120(M离纹点位状态U3001正常点位枢态113002预瞥点位状态113003故障点位状态113004阳线tt*1160()1厂*Att*1160(以B设备型号117100MOOEi.-1燃气种类118001天然气燃气种类18002液化石油气供气企业119001题门HR燃气有跟公司供气企业119002度门中油IR航油气有Hi公司供气企业119003患门奥顺公油液化气有双公司供气企业U9(M>4坦门华达石化工程有架公司供气企业119O(>5展门市同安金裕盛液化气有限公司供气企业UgO(Xi厦门市杏泰液化气右阳公司供气企业U9007及门巾同气耨气有限公司用户种类120001-JWSR用户种类120002超高尾居民用户肺类120003商业用户用户种类120001工业用户所Bt行业121001玲通居民所限行业121002机关单位所6行业121003医院所M行业1210(M学校所触行业1210()5标合体断SI行业121006公共福利所K行业121007文族酒店所限行业121008商务餐饮所限行业121009特种暇务所属行业121010厂矿金业所Bt行业12J011其它处置反馈124001仔收告警处置反馈124O(>2i5t备决投处置反馈124003用户测试处置反馈124O(M钢瓶换气处置反愦1240098平台接口格式要求8.1 接口分类本文件接口遵循RESTfU1.AP1.规范,数据接口包括外部档案数据同步、预警数据推送、预警处过三类。8.2 接口格式接口描述茶干如下菸本格式:WebService:=<METHOD><ENTRY><PAR1M><IODER><SREAM>各字段的含义如下表所示.HTTP请求的返回结果包含两部分:一部分为HrrP消息的状态码(StatusCode),我示响应的状态:另一部分为HTTP请求的消忠体,消总体默认采用JSoN格式进行封装,字段含义<ME1W0D>HnP请求的方法.本接口中使用到的值有GET.POST.PUT和DE1.EIE,名取值的含义参与HrTP协议.<ENTRV>N由Oi务接口的入。地址.<PARAV>可选参数,用以传迤少Ift的布ik信息,<HEADER>HnP请求的消恩头部.<STKhAM>可选的附加源信息,用以传龙大祭的餐致信息,所有接口定义格式说明如下:a)接口名:接口的名称:b)说明:对接口内容的描述:c>倜用格式:调用web服务时的语法格式:<0语义:对调用格式的解佯:C)词用结果:WCb服务调用结果,包括成功状态和失败状态的下的响应信息。如无特殊说明,所有取电服务接口调用时都应完成接口签名。签Z格式见卜表:警数名称格式必填说明startstring是(XIrequestmethadstring是请求类型,按https标准执行.叩T/DEIITWPaST/GETcontcnt-typrJJtring½请求内容的类型5ig11-sccretstring是或用服务系统授权密树access-tokenstring½应用IH务系统授权Tokenaccess-idtiring是应用收务系统授横向用编写bodystring传电的数榭流ondstring足00签名算法采用:HmaCSHA,是种施于密钥的报支完整性的5证方法,不可逆加密,其安全性是建立在HUSh加密算法基础上的。它要求通信双方共享密切、约定律法、时报文进行HaSh运算,形成固定长度的认证码。通信双方通过认证码的校验来确定报文的合法性.If1.1.AC是密的相关的哈希运算消息认证码(IIaShbasedMessageAuthenticationCode),HMAC运算利用哈希算法,以一个南钥和一个消息为输入,生成一个消息摘要作为输出。8.3 HTTP状态码常刖的HTTp状态码表示及含义见下表,未列举状态码的名称及含义参考HrrP协议的定义.状态码Si号状态码名称含义200OK请求已成功,201Crmtrd对象或费海已成功创建.202Accepted操作已被成功接受.302Found小定向跳转.400BK(IRequest请求的内容工失或不合法.101Unauthorized当前请求需要用户验证.401NotFound请求的内容不存在.105MethodNotA1.1.owed客户端请求中的方法被禁止.409Conf1.ict访时冲突,访问资源已被上校或M能牛致眼仿济内簪状态出惜.115UnsupportedMediaType限务法无法处理谙求阳蒂的媒体格式.500Interna1.ServerError.城务法出现内部错误.无法正确响应请求.503SOrViCgVnavai!ab1.e谈务器服务的不可用,9平台接口信息9.1 监测点位新增接1.I名:point/add说明:新增监测点位档案调用格式:POSTqj-ant-rr>nitorv1.openapipointa<k1.<STREM>语义:创建监测点位.附加渔<STREW>指定该点位所涉及的相关信息.包括但不限于:点位名称、点位编码、点位类型、点位地址、点位联系人等,支持JSoN格式.调用结果:成功状态:返回IrnP状态码为200.失败状态:返回失败对应的HTTP状态码及采用JSON时装的响应结果。响应结果包含失败原因,具体状态码参见目录8.3.9.2 监测点位编辑接口名:pointcdit说明:端辑监测点位档案调用格式:POSTqjantmonitor/v1./openapi/point/edit<STREM>语义:更新指定点位编码的点位档案信息。附加流<STREAM>为更新后的数据对象,支持JSON格式.调用结果,成功状态:返回HTTP状态码为200.失败状态:返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状态码参见目录8.3.9.3 监测点位删除接口名:point/dc1.说明:删除监测点位,同时会级联删除该点位梆定的所有设得.网用格式:DE1.ETEqj-ant-t>nitor/v1./openapi/poinc/(1.c?<Jomain1.(1.=(<1.nsain1.<1.4n>niIorCode=11>nito,Co<ie)语义r删除指定点位编码的点位档案信息.倜用结果:成功状态:返回IrrTP状态码为200.失败状态:返回失败对应的HTTP状态码及采用JSON时装的响应结果,响应结果包含失败原因,具体状态码参见目录8.3。9.4 设备新增接口名:device/add说明:新增监测设符档案周川格式:POSTqjantmonitor/v1openapidevice/add<STREM>语义:创建监测设法.附加流<STRENI指定该设法所涉及的相关信息,包括但不限于;设备名称、设备编码、设备类型、安装地址等,同时通过STREAM)中指定的点位编码<BonitorCodc)将设备绑定到该监测点位上.支持JSO格式.圜用结果:成功状态;返回IrnP状态玛为200«失败状态:返网失败对应的HTTP状态码及采用JS(N封装的响应结果,响应结果包含失败原因,具体状态码卷见目录8.3。