版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
ICS35.020CCSL70
6101西 安 市 地 方 标 准DB6101/T3188—2024检验检测数据管理规范数据接口20242024060420240704西安市市场监督管理局 发布DB6101/T3188DB6101/T3188—2024DB6101/T3188DB6101/T3188—2024目 次前 言 II范围 1规范性引用文件 1术语和定义 1缩略语 1接口通信 1通信方式 1通信要求 1接口传输 2传输协议 2传输内容 2接口格式 2报文结构 2报文头 2报文结构 2报文头 2报文体 29接口验证 8验证内容 8验证环境 8验证方式 8I附录A(资料性)报文信息JSON结构示例 9附录B(资料性)报文信息XML结构示例 10参考文献 11前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由西安市市场监督管理局提出并归口。本文件主要起草人:王晖、周强、祝凯、畅亚文、张源、刘欣、王彬彬、曹珺溥、胡亚芹、王佩、张琛、王雨润、王磊、荀漪、郭丹。本文件由瑞特认证检测集团有限公司负责解释。本文件首次发布。地址:陕西省西安市蓝田县华胥镇西北家具工业园新港七路8号电话编:710523II地址:陕西省西安市蓝田县华胥镇西北家具工业园新港七路8号电话编:710523II检验检测数据管理规范数据接口范围规范性引用文件(包括所有的修改单适用于本文件。GB/T7408.1日期和时间信息交换表示法第1部分:基本原则DB6101/T3182—2024检验检测数据管理规范数据元术语和定义本文件没有需要界定的术语和定义。4缩略语4缩略语下列缩略语适用于本文件。FTP:文件传输协议(FileTransferProtocol)HTTP:超文本传输协议(HyperTextTransferProtocol)HTTPS:超文本安全传输协议(HyperTextTransferProtocoloverSecureSocketLayer)IP:网络之间互联的协议(InternetProtocol)JSON:JavaScript对象表示法(JavaScriptObjectNotation)URL:统一资源定位符(UniformResourceLocator)XML:可扩展标记语言(ExtensibleMarkupLanguage)5接口通信通信方式应明确通信方式,适用时包括:同步应答、异步应答、广播通知、文件传输等。通信要求采用不同的通信方式时,应符合:——同步应答时,发起方向接收方发送检验检测数据请求,发送方等待接收方处理结果,接收方应处理,并返回处理结果;——异步应答时,发起方向接收方发送检验检测数据请求,发起方不再等待接收方处理结果,由接收方处理完成后向发起方发送回执;1——广播通知时,发送方向一个或者多个接收方以广播通知的方式推送单个或者多个信息,由接收方在适当的时候处理信息;——文件传输时,发送方和接收方通过文件的方式来传输信息。接口传输传输协议应支持多种传输协议,满足机密性、完整性、可用性的要求,包括但不限于:——HTTP、FTP和Socket(套接字):应对传输信息的部分或者全部内容进行加密、签名等方式进行处理,以防止在传输过程中造成的数据泄密和数据篡改;——HTTPS:应采用有效认证方式,以保障交互双方的有效性和合法性。传输内容接口传输的检验检测数据元、数据类型、数据格式、约束条件应符合DB6101/T3182—2024中第6章、第7章的要求。接口格式接口格式应包括但不限于:接口名称:数据接口的名称,一般为接口功能描述;88接口名称:数据接口的名称,一般为接口功能描述;88返回状态:数据接口的调用状态码。注:接口调用状态码,可以采用协议定义或自定义的状态码。8接口报文报文结构报文结构中应包含报文头、报文体,支持多种格式,包括但不限于JSON和XML。JSON结构示例参见附录A。XML结构示例参见附录B。注:FTP、Socket报文结构可参考上述方式。报文头报文头用于表述报文中的通用信息,包括但不限于以下信息:——调用标识:接口调用方的唯一标识;——响应标识:接口响应方的唯一标识;——身份令牌:身份验证和授权标识;——发送时间:接口报文发送的时间,其时间格式应符合GB/T7408.1的规定。报文体8.3.1委托信息参数2//表1委托方信息参数参数名含义类型是否必填项说明customerName委托方名称String是委托方名称customerContact委托方联系人String是委托方联系人customerPhone委托方电话String是委托方电话customerAddress委托方地址String否委托方地址表2委托样品信息参数参数名含义类型是否必填项说明sampleName样品名称String是样品名称sampleTrademark样品商标String否样品商标sampleProduceUnit生产单位String是样品生产单位sampleProduceUnitAdress生产单位地址String是生产单位地址sampleModel样品规格String是样品规格sampleCount样品数量Float是样品数量sampleUnit样品单位String是最小独立包装规格的单位sampleProducedDate生产日期Date是样品生产日期sampleValidDate有效期String否样品有效期sampleValidEndDate有效期截止日期Date否样品有效期截止日期sampleFormerNumber样品批号String是样品批号sampleLicenseNumber生产许可证号String否样品生产许可证号sampleSourceType样品来源String是委托方送检委托方快递检测方取样其他sampleSaveRequire样品保存要求String是常温避光低温其他33表4检/试验项目信息参数8.3.2委托受理信息参数表4检/试验项目信息参数8.3.2委托受理信息参数委托受理信息参数应符合表5的要求。表5委托受理信息参数4表2委托样品信息参数(续)参数名含义类型是否必填项说明sampleHandleType样品处理String是报废退样留样超期处理其他sampleRemarks样品备注String否样品备注3检/试验要求信息参数参数名含义类型是否必填项说明detectionCategory检/试验类别String是委托检验型式检验比对试验其他detectionStandard检/试验依据String是检/试样品所依据的产品标准detectionItemList检/试验项目List是检/试验项目数组,采用数组形式表示,见表4参数名含义类型是否必填项说明detectionItem检/试验项目String是检/试验项目detectionMethod检/试验方法String是检/试验项目所规定的检/试验方法参数名含义类型是否必填项说明sampleNumber样品编号String是由检验单位赋予检验样品的唯一性编号,依据一定编码规则生成sampleCollectDate收样日期String是检验单位受理样品当日的公元纪年日期sampleStateDes样品状态String是接收检品和移交检品时的外包装情况acceptPerson受理人员String是检验单位受理样品时进行办理的业务人员trustee检验单位String是检/试验样品的组织机构名称detectionStandard检/试验依据String是检/试验样品所依据的产品标准表5委托受理信息参数(续)参数名含义类型是否必填项说明sampleReceiveCount收样数量Float是检验单位接收样品的数量sampleReceiveUnit收样数量单位String是独立包装规格的单位usedPosition检测部位String否现场检测时工程结构的构件名称或部位representBatch代表批量String否代表批量isRetainSample是否留样Boolean否样品是否留样sampleBackupCount留样数量Float否样品留样数量sampleBackupUnit留样数量单位String否样品留样数量单位sampleBackupEndDate留样保存截止时间Date否样品留样保存截止时间samplePosition存放位置String是样品保存的实际地点detectionItemList检验项目List是检/试验项目数组,采用数组形式表示,见表4reportExpectData拟提供检验检测报告日期Date否拟提供检验检测报告日期sampleReturnType退样方式String否退还检验样品采用的方式(快递、自取等)sampleReturnCount退样数量Float否样品退样数量sampleReturnUnit退样数量单位String是样品退样数量单位reportSendType报告发放方式String是电子版自取邮寄其他detectionFee检验费用Float否检验费用otherFee其他费用Float否其他费用totalFee检验总费用Float否检验总费用.3检/试验记录参数检/试验记录参数应包含检/试验人员信息、检/试验设备信息、检/试验样品信息、检/试验项目信息、检/试验环境信息。检/试验人员信息应符合表6的要求,检/试验设备信息应符合表7的要求,检/5试验样品信息应符合表8/试验项目信息应符合表9/试验环境信息应符合表10的要求。6检/试验人员信息参数参数名含义类型是否必填项说明testDept检验部门String是承担样品当前项目检验工作责任的科室名称,若存在多个,以逗号间隔testerName检验员姓名String是检验员姓名testerNo检验员编号String否检验员编号testEndTime检验完成时间Date是检验完成时间reviewer复核人员String是复核人员reviewerNo复核人员编号String否复核人员编号reviewerDate复核完成时间Date是复核完成时间表8检/试验样品信息参数表9检/试验项目信息参数67表8检/试验样品信息参数表9检/试验项目信息参数6参数名含义类型是否必填项说明equName设备名称String是设备名称equManageNumber设备管理编号String是设备管理编号参数名含义类型是否必填项说明entrustId委托唯一标识String是委托单唯一标识sampleName样品名称String是样品名称sampleCount领样数量String是领样数量sampleState样品状态String否试验时样品状态参数名含义类型是否必填项说明detectionItem检/试验项目String是检/试验项目detectionMethod检/试验方法String是检/试验项目所规定的检/试验方法detectionValue检/试验结果值String是检/试验结果值表12检/试验设备信息参数表12检/试验设备信息参数表13报告信息参数7detectionUnit检/试验结果值单位String是标准中规定的检/试验结果值的单位10检/试验环境信息参数参数名含义类型是否必填项说明labName试验室名称String是试验室名称labEnv试验室环境String否试验室环境,应根据试验要求气压、照度等。8.3.4报告信息参数//试验设备1211检/试验项目信息参数参数名含义类型是否必填项说明detectionItem检/试验项目String是检/试验项目detectionMethod检/试验方法String是检/试验方法detectionResult检/试验结果值String是试验结果值detectionUnit检/试验结果值单位String是标准中规定的检/试验结果值的单位standardValue标准值String否标准中规定的检/试验项目的值参数名含义类型是否必填项说明equList检/试验使用的设备列表List是检/7参数名含义类型是否必填项说明reportNumber报告编号String是由检验单位赋予检验报告的唯一性编号reportConclusion报告结论String是检验结论uncertainty测量不确定度Float否测量不确定度detectionCycle检/试验日期String是从检/试验开始到结束的时间段testerName检验人String是检验人姓名revieweName报告审核人String是报告审核人姓名表13报告信息参数(续)参数名含义类型是否必填项说明revieweDate报告审核日期Date是报告审核日期approvalName授权签字人String是授权签字人姓名reportApprovalDate报告签发日期Date是报告签发日期reportPrinter报告打印人String否报告打印人姓名reportPrintDate报告打印日期Date否报告打印日期9接口验证验证内容第5章~第8章中的要求,以及环境要求。验证环境验证环境应符合运行接口服务所需的操作系统及测试程序软件。验证方式验证方式验证流程应按照接口文档规定的接口名称和接口参数进行验证,通信方式应符合第5章的要求,传输协议应符合第6章的要求,接口的报文数据应符合第7章、第8章的要求。8附录 A(资料性)报文信息JSON结构示例下面给出了JSON结构的报文信息示例。请求示例:Method:GETPath:/getReportInfoByNumberContent-Type:application/json;charset=UTF-8Host:Token:tokenTimestamp:1686980240{"reportNumber":"RCD2023(B)01010001"}响应示例:"code":200,"message":"请求成功","timestamp":"1686980250","data":{"customerName":"委托方","customerContact":"委托人","customePhone":"159****1234","sampleName":"背贴式橡胶止水带","code":200,"message":"请求成功","timestamp":"1686980250","data":{"customerName":"委托方","customerContact":"委托人","customePhone":"159****1234","sampleName":"背贴式橡胶止水带","sampleModel":"背贴式橡胶止水带350mm×8mm","sampleTrademark":"样品商标","sampleProduce":"生产单位",......}}9附录 B(资料性)报文信息XML结构示例下面给出了XML结构的报文信息示例。请求示例:<?xmlversion="1.0"encoding="UTF-8"?><request><Method>GET</Method>
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- (新)事业单位统考《综合应用能力A类》考试及标准答案解析
- 月嫂应聘面试题库及答案
- 2026年熔化焊接与热切割考试模拟试卷带答案
- 2026年中小学语文作文素材积累模拟试卷带答案
- 2026年揭阳市消防救援支队招聘85名政府专职消防员考试题库及参考答案
- 2026年缅甸英文模拟试卷(含答案)
- 2026年聚乙烯醇制造工三级安全教育(车间级)考核模拟试卷带答案
- 2026年留置尿管模拟试卷(含答案)
- 2026年民航安检新试题库及答案
- 2026年学习减分考试题库带答案
- 建筑工程质量培训课件
- 《生物化学》课件-三羧酸循环
- 公路工程监理质量控制措施
- 身体约束管理制度流程
- 第8章TiAl系金属间化合物
- 沈阳城投新能源集团有限公司招聘笔试冲刺题2025
- 建筑表现生涯发展展示
- 与数同行 共话梦想-四年级数学期中家长会 课件
- 卫生院服务基层行资料-2.2.1.10 康复医疗服务★
- 《数据、模型与决策》 课件 3.2 DEA数据包络分析
- 劳动教育通论1-11章完整版课件
评论
0/150
提交评论