设备维护平台接口技术规范说明书2023-05-13

1、 设备维护平台接口技术标准说明书版本号 V1.0杭州天梦科技二一年五月更改履历版本号修改编号更改时间更改的图表和章节更改简要描述更改人批准人V1.02013-05-13创立，形成初稿叶庆国V1.12014-06-09维修业务操作接口调整，仅开放维保单位相关操作接口叶庆国注：更改人除形成初稿，以后每次修改在未批准确认前均需采用修订的方式进行修改。目 录 TOC o 1-3 f h z HYPERLINK l _Toc390156462 1概述 PAGEREF _Toc390156462 h 2 HYPERLINK l _Toc390156463 1.1编写目的 PAGEREF _Toc39015

2、6463 h 2 HYPERLINK l _Toc390156464 1.2预期读者 PAGEREF _Toc390156464 h 2 HYPERLINK l _Toc390156465 1.3参考文献 PAGEREF _Toc390156465 h 2 HYPERLINK l _Toc390156466 2接口平台设计 PAGEREF _Toc390156466 h 2 HYPERLINK l _Toc390156467 2.1技术架构 PAGEREF _Toc390156467 h 2 HYPERLINK l _Toc390156468 接口架构图 PAGEREF _Toc3901564

3、68 h 2 HYPERLINK l _Toc390156469 业务流图 PAGEREF _Toc390156469 h 3 HYPERLINK l _Toc390156470 2.2部署方式 PAGEREF _Toc390156470 h 4 HYPERLINK l _Toc390156471 2.3接口标准 PAGEREF _Toc390156471 h 4 HYPERLINK l _Toc390156472 技术标准 PAGEREF _Toc390156472 h 4 HYPERLINK l _Toc390156473 数据规约 PAGEREF _Toc390156473 h 5 HY

4、PERLINK l _Toc390156474 例如 PAGEREF _Toc390156474 h 6 HYPERLINK l _Toc390156475 3Webservice效劳 PAGEREF _Toc390156475 h 7 HYPERLINK l _Toc390156476 3.1设备维护平台提供的效劳 PAGEREF _Toc390156476 h 7 HYPERLINK l _Toc390156477 接口效劳清单 PAGEREF _Toc390156477 h 7 HYPERLINK l _Toc390156478 接口效劳设计 PAGEREF _Toc390156478

5、h 8概述编写目的为设备维护平台的信息同步和共享，制定了统一的接口标准，用来指导各系统的接口设计、开发、联调及迁移工作。范围：本文档主要是对设备维护平台与外围业务系统的数据交互需求进行说明。调试要求强烈要求第三方调用者，先做测试库的接口调试，确保接口及参数调用正确，否那么将对正式库可能出现的系统故障承担主要责任。预期读者工程组人员、各交互系统涉及到的开发厂家。参考文献?智能交通设备维护管理系统设备接入标准?杭州天梦科技接口平台设计技术架构接口架构图暂缺业务流图说明：用户通过接口。部署方式接口效劳层包括Webservice效劳、展现集成效劳。Webservice效劳各系统提供的接口效劳统一部署在

6、设备维护平台接口效劳层上，各系统客户端和接口效劳层用SOAP协议通过 来交互，客户端根据WSDL描述文档生成SOAP请求消息发送到效劳端，效劳端解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答送回到客户端。展现集成效劳展现集成效劳主要是应用界面集成效劳，由效劳提供方提供详细的URL及相关参数说明，调用方传入参数，调用效劳方提供的页面进行展现。平台Service组件效劳平台Service组件效劳统一部署在设备维护平台接口效劳层上，通过平台接口效劳层进行查询操作。接口标准技术标准简述客户端和效劳器用SOAP协议通过 来交互，客户端根据WSDL描述文档生成SOAP请求

7、消息发送到效劳端，效劳端解析收到的SOAP请求，调用Web service，然后再生成相应的SOAP应答送回到客户端。认证机制设备维护平台提供的所有WebService效劳均需要认证授权才能被调用，Webservice效劳接收到请求后从传入参数中获取用户名和密码，进行认证，认证通过后再调用具体效劳。数据规约简述客户端和效劳端采用XML格式的字符串来交互业务数据，客户端将业务数据组织成XML格式的字符串作为最后一个入参调用效劳端接口，效劳端解析XML格式的字符串得到业务数据处理业务并把结果组织成XML格式的字符串返回给客户端。接口调用的结果，自动序列化后，以XML格式的字符串返回，其中包含了接口

8、调用中出现的错误描述。 格式约定假设是业务接口调用，将以DataItem_Rsp类实例序列化，表示单一数据项，内容包括操作结果、错误描述，无数据集。假设是查询接口调用，将以EntSetSerialize_Rsp类实例序列化，表示查询结果，其中包括错误描述，有数据集。XML字符串中，假设是节点取值为null，那么是，在节点中存在属性xsi:nil=true；假设是节点取值为空字符串，那么是。XML编码格式为“UTF-8”；字段为日期的遵循以下约定：年月日格式统一为“YYYY-MM-DD，如“2006-06-22”。年月格式为“YYYYMM，如“200606”。包含时间的日期格式统一为“YYYY-

9、MM-DDTHH:MI:SS，如“2006-06-22T14:00:00”。如果未约定日期格式，那么DATE类型的默认为“YYYY-MM-DD，如“2006-06-22。格式DTD暂缺例如例如：查询接口，包含数据集 0 0 操作成功 3 3 10 0 1 true e4fb99cf-108b-4688-b124-43ae8a2b5787 可控的故障维修 900308010 ead3b6fb-0c5e-482c-892d-d629f57b75ef 900501010 900308010 10 1 可控的故障维修 2011-09-26T17:20:17 true 195a341c-35dc-43a

10、b-a2fc-b050be12ea0c 不可控的故障维修 900308020 ead3b6fb-0c5e-482c-892d-d629f57b75ef 900501010 900308020 20 1 不可控的故障维修 2011-09-26T17:20:32.187 true c648d4d3-9a7e-4f3f-8a2f-96f94cb9d978 频繁上下线 900308030 ead3b6fb-0c5e-482c-892d-d629f57b75ef 900501010 900308030 22 1 频繁上下线 2011-11-24T23:28:17.953 例如：业务接口，只有返回标识 0

11、 0 授权帐号验证失败 System.Boolean False Webservice效劳设备维护平台提供的效劳由于各用户单独安装部署，故对于WebService效劳地址，另外单独提供。接口效劳清单序号效劳名称接口名称说明调用方频率ClientUserCheck客户端信息验证第三方实时BaseData_DevList根底数据.设备清单查询第三方实时BaseData_OrgList根底数据.组织机构及设备分组清单查询第三方实时BaseData_DictionaryList根底数据.数据字典代码项查询第三方实时DevRep_FaultSearch业务流程.故障上报查询第三方半小时DevRep_Fa

12、ultReport故障上报第三方半小时DevRep_RepairSearch业务流程.报修查询第三方半小时DevRep_RepFeeApp维修报价申请第三方半小时DevRep_FaultRsp维修响应第三方半小时DevRep_FaultFeedback维修反响第三方半小时DevRep_RepairAudit维修审核第三方半小时接口效劳设计客户端信息验证效劳名称ClientUserCheck接口声明public DataItem_Rsp ClientUserCheck(string clientUser, string clientPwd, string clientIp)描述客户端信息验证中文

13、名字段名长度类型非空说明及数据要求入参登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ItemType 数据项类型ItemValue数据项取值ErrorDesc错误描述部署情况设备维护平台根底数据，设备清单查询效劳名称BaseData_DevList接口声明public EntSetSerialize_Rsp BaseData_DevList(string devType, string devIp, string devGuid, string devCodeSdk, string

14、 devChannel, string unitRepGuid, Int32 pageIndex, string clientUser, string clientPwd, string clientIp)描述根底数据.设备清单查询中文名字段名长度类型非空说明及数据要求入参设备类型devTypestringN设备IPdevIpstringN设备GUIDdevGuidstringN设备接口编号 devCodeSdkstringN来自第三方设备平台设备通道号devChannelstringN维保单位GUIDunitRepGuidstringN作为维保方，其登录帐号所属单位GUID，可作为维保单位G

15、UID页索引pageIndexInt32Y登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ErrorDesc错误描述TotalCount数据查询结果的总记录数RspCount实际返回的记录数RspPageSize分页查询的页大小RspPageIndex分页查询的页索引RspPageTotal分页查询的页总数EntList数据查询结果列表,采用泛型集合List，自动序列化产生，根据查询接口不同，其中嵌套的对象及其字段名称也不同，以实际返回结果为准部署情况设备维护平台根底数据，组织机构及

16、设备分组查询效劳名称BaseData_OrgList接口声明public EntSetSerialize_Rsp BaseData_OrgList(Int32 pageIndex, string clientUser, string clientPwd, string clientIp)描述根底数据.组织机构及设备分组清单查询中文名字段名长度类型非空说明及数据要求页索引pageIndexInt32Y登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ErrorDesc错误描述TotalC

17、ount数据查询结果的总记录数RspCount实际返回的记录数RspPageSize分页查询的页大小RspPageIndex分页查询的页索引RspPageTotal分页查询的页总数EntList数据查询结果列表,采用泛型集合List，自动序列化产生，根据查询接口不同，其中嵌套的对象及其字段名称也不同，以实际返回结果为准部署情况设备维护平台根底数据，数据项查询效劳名称BaseData_DictionaryList接口声明public EntSetSerialize_Rsp BaseData_DictionaryList(Int32 pageIndex, string nodeCategory,

18、string nodeType, string clientUser, string clientPwd, string clientIp)描述根底数据.数据字典代码项查询中文名字段名长度类型非空说明及数据要求页索引pageIndexInt32Y节点大类nodeCategorystringY故障原因大类-900501010故障原因细类-900501020节点细类nodeTypestringN登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ErrorDesc错误描述TotalCount

19、数据查询结果的总记录数RspCount实际返回的记录数RspPageSize分页查询的页大小RspPageIndex分页查询的页索引RspPageTotal分页查询的页总数EntList数据查询结果列表,采用泛型集合List，自动序列化产生，根据查询接口不同，其中嵌套的对象及其字段名称也不同，以实际返回结果为准部署情况设备维护平台业务流程，故障上报查询效劳名称DevRep_FaultSearch接口声明public EntSetSerialize_Rsp DevRep_FaultSearch(string reportUnitGuid, string faultAuditStatus, str

20、ing devType, string faultType, string faultTimeStart, string faultTimeEnd, string repStatus, string jobNo, string deviceGuid, int pageIndex, string clientUser, string clientPwd, string clientIp)描述业务流程.故障上报查询中文名字段名长度类型非空说明及数据要求入参上报单位GUIDreportUnitGuidstringN作为维保方，其登录帐号所属单位GUID，可作为上报单位GUID故障审核状态faultA

21、uditStatusstringN设备类型devTypestringN故障类型faultTypestringN开始时间faultTimeStartstringN故障时间结束时间faultTimeEndstringN故障时间维修状态repStatusstringN工单号jobNostringN设备GUIDdeviceGuidstringN页索引pageIndexInt32Y登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ErrorDesc错误描述TotalCount数据查询结果的总记录

22、数RspCount实际返回的记录数RspPageSize分页查询的页大小RspPageIndex分页查询的页索引RspPageTotal分页查询的页总数EntList数据查询结果列表,采用泛型集合List，自动序列化产生，根据查询接口不同，其中嵌套的对象及其字段名称也不同，以实际返回结果为准部署情况设备维护平台业务流程，故障上报效劳名称DevRep_FaultReport接口声明public DataItem_Rsp DevRep_FaultReport(string deviceGuid, string fault_Time, string fault_Type, string fault_

23、Remark, string clientUser, string clientPwd, string clientIp)描述故障上报中文名字段名长度类型非空说明及数据要求设备GUIDdeviceGuidstringY故障时间fault_TimestringY故障类型fault_TypestringY故障类型编号，可在数据项中查询，参考参数如下节点大类，900501005节点细类，900504050故障描述fault_RemarkstringY登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1

24、：无错误ItemType 数据项类型ItemValue数据项取值ErrorDesc错误描述部署情况设备维护平台业务流程，报修查询效劳名称DevRep_RepairSearch接口声明public EntSetSerialize_Rsp DevRep_RepairSearch(string reportUnitGuid, string repTransferStatus, string devType, string faultType , string faultTimeStart, string faultTimeEnd, string repStatus, string jobNo, st

25、ring deviceGuid, int pageIndex , string clientUser, string clientPwd, string clientIp)描述业务流程.报修查询中文名字段名长度类型非空说明及数据要求入参上报单位GUIDreportUnitGuidstringN作为维保方，其登录帐号所属单位GUID，可作为上报单位GUID维修移交状态repTransferStatusstringN设备类型devTypestringN故障类型faultTypestringN开始时间faultTimeStartstringN故障时间结束时间faultTimeEndstringN故障

26、时间维修状态repStatusstringN工单号jobNostringN设备GUIDdeviceGuidstringN页索引pageIndexInt32Y登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ErrorDesc错误描述TotalCount数据查询结果的总记录数RspCount实际返回的记录数RspPageSize分页查询的页大小RspPageIndex分页查询的页索引RspPageTotal分页查询的页总数EntList数据查询结果列表,采用泛型集合List，自动序列化产

27、生，根据查询接口不同，其中嵌套的对象及其字段名称也不同，以实际返回结果为准部署情况设备维护平台业务流程，维修报价申请效劳名称DevRep_RepFeeApp接口声明public DataItem_Rsp DevRep_RepFeeApp(string fault_Repair_Unit_Guid, string repFeeMemo, decimal repFee, string clientUser, string clientPwd, string clientIp)描述维修报价申请中文名字段名长度类型非空说明及数据要求维修记录GUIDfault_Repair_Unit_Guidstrin

28、gY申请描述repFeeMemostringY申请费用repFeedecimalY登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ItemType 数据项类型ItemValue数据项取值ErrorDesc错误描述部署情况设备维护平台业务流程，维修响应效劳名称DevRep_FaultRsp接口声明public DataItem_Rsp DevRep_FaultRsp(string fault_Repair_Unit_Guid, string fault_Reason_Memo, str

29、ing clientUser, string clientPwd, string clientIp)描述维修响应中文名字段名长度类型非空说明及数据要求维修记录GUIDfault_Repair_Unit_GuidstringY维修响应说明fault_Reason_MemostringY登录帐号clientUserstringY登录密码clientPwdstringY用户IPclientIpstringY出参IsError0：有错误；1：无错误ItemType 数据项类型ItemValue数据项取值ErrorDesc错误描述部署情况设备维护平台业务流程，维修反响效劳名称DevRep_FaultFeedback接口声明public DataItem_Rsp DevRep_FaultFeedback(string fault_Repair_Unit_Guid, string feedback_Memo, int repairMinute_DelayAppaly, string faul