ICS35.020CCSL70

6101西 安 市 地 方 標 準DB6101/T3188—2024檢驗檢測數據管理規(guī)范數據接口20242024060420240704西安市市場監(jiān)督管理局??發(fā)布DB6101/T3188DB6101/T3188—2024DB6101/T3188DB6101/T3188—2024目 次前 言 II范圍 1規(guī)范性引用文件 1術語和定義 1縮略語 1接口通信 1通信方式 1通信要求 1接口傳輸 2傳輸協(xié)議 2傳輸內容 2接口格式 2報文結構 2報文頭 2報文結構 2報文頭 2報文體 29接口驗證 8驗證內容 8驗證環(huán)境 8驗證方式 8I附錄A（資料性）報文信息JSON結構示例 9附錄B（資料性）報文信息XML結構示例 10參考文獻 11前 言本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由西安市市場監(jiān)督管理局提出并歸口。本文件主要起草人：王暉、周強、祝凱、暢亞文、張源、劉欣、王彬彬、曹珺溥、胡亞芹、王佩、張琛、王雨潤、王磊、荀漪、郭丹。本文件由瑞特認證檢測集團有限公司負責解釋。本文件首次發(fā)布。地址：陜西省西安市藍田縣華胥鎮(zhèn)西北家具工業(yè)園新港七路8號電話編：710523II地址：陜西省西安市藍田縣華胥鎮(zhèn)西北家具工業(yè)園新港七路8號電話編：710523II檢驗檢測數據管理規(guī)范數據接口范圍規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T7408.1日期和時間信息交換表示法第1部分：基本原則DB6101/T3182—2024檢驗檢測數據管理規(guī)范數據元術語和定義本文件沒有需要界定的術語和定義。4縮略語4縮略語下列縮略語適用于本文件。FTP:文件傳輸協(xié)議（FileTransferProtocol）HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）HTTPS：超文本安全傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）IP：網絡之間互聯的協(xié)議(InternetProtocol)JSON：JavaScript對象表示法(JavaScriptObjectNotation）URL：統(tǒng)一資源定位符(UniformResourceLocator)XML：可擴展標記語言（ExtensibleMarkupLanguage）5接口通信通信方式應明確通信方式，適用時包括：同步應答、異步應答、廣播通知、文件傳輸等。通信要求采用不同的通信方式時，應符合：——同步應答時，發(fā)起方向接收方發(fā)送檢驗檢測數據請求，發(fā)送方等待接收方處理結果，接收方應處理，并返回處理結果；——異步應答時，發(fā)起方向接收方發(fā)送檢驗檢測數據請求，發(fā)起方不再等待接收方處理結果，由接收方處理完成后向發(fā)起方發(fā)送回執(zhí)；1——廣播通知時，發(fā)送方向一個或者多個接收方以廣播通知的方式推送單個或者多個信息，由接收方在適當的時候處理信息；——文件傳輸時，發(fā)送方和接收方通過文件的方式來傳輸信息。接口傳輸傳輸協(xié)議應支持多種傳輸協(xié)議，滿足機密性、完整性、可用性的要求，包括但不限于：——HTTP、FTP和Socket(套接字)：應對傳輸信息的部分或者全部內容進行加密、簽名等方式進行處理，以防止在傳輸過程中造成的數據泄密和數據篡改；——HTTPS：應采用有效認證方式，以保障交互雙方的有效性和合法性。傳輸內容接口傳輸的檢驗檢測數據元、數據類型、數據格式、約束條件應符合DB6101/T3182—2024中第6章、第7章的要求。接口格式接口格式應包括但不限于：接口名稱：數據接口的名稱，一般為接口功能描述；88接口名稱：數據接口的名稱，一般為接口功能描述；88返回狀態(tài)：數據接口的調用狀態(tài)碼。注：接口調用狀態(tài)碼，可以采用協(xié)議定義或自定義的狀態(tài)碼。8接口報文報文結構報文結構中應包含報文頭、報文體，支持多種格式，包括但不限于JSON和XML。JSON結構示例參見附錄A。XML結構示例參見附錄B。注：FTP、Socket報文結構可參考上述方式。報文頭報文頭用于表述報文中的通用信息，包括但不限于以下信息：——調用標識：接口調用方的唯一標識；——響應標識：接口響應方的唯一標識；——身份令牌：身份驗證和授權標識；——發(fā)送時間：接口報文發(fā)送的時間，其時間格式應符合GB/T7408.1的規(guī)定。報文體8.3.1委托信息參數2//表1委托方信息參數參數名含義類型是否必填項說明customerName委托方名稱String是委托方名稱customerContact委托方聯系人String是委托方聯系人customerPhone委托方電話String是委托方電話customerAddress委托方地址String否委托方地址表2委托樣品信息參數參數名含義類型是否必填項說明sampleName樣品名稱String是樣品名稱sampleTrademark樣品商標String否樣品商標sampleProduceUnit生產單位String是樣品生產單位sampleProduceUnitAdress生產單位地址String是生產單位地址sampleModel樣品規(guī)格String是樣品規(guī)格sampleCount樣品數量Float是樣品數量sampleUnit樣品單位String是最小獨立包裝規(guī)格的單位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委托樣品信息參數（續(xù)）參數名含義類型是否必填項說明sampleHandleType樣品處理String是報廢退樣留樣超期處理其他sampleRemarks樣品備注String否樣品備注3檢/試驗要求信息參數參數名含義類型是否必填項說明detectionCategory檢/試驗類別String是委托檢驗型式檢驗比對試驗其他detectionStandard檢/試驗依據String是檢/試樣品所依據的產品標準detectionItemList檢/試驗項目List是檢/試驗項目數組，采用數組形式表示，見表4參數名含義類型是否必填項說明detectionItem檢/試驗項目String是檢/試驗項目detectionMethod檢/試驗方法String是檢/試驗項目所規(guī)定的檢/試驗方法參數名含義類型是否必填項說明sampleNumber樣品編號String是由檢驗單位賦予檢驗樣品的唯一性編號，依據一定編碼規(guī)則生成sampleCollectDate收樣日期String是檢驗單位受理樣品當日的公元紀年日期sampleStateDes樣品狀態(tài)String是接收檢品和移交檢品時的外包裝情況acceptPerson受理人員String是檢驗單位受理樣品時進行辦理的業(yè)務人員trustee檢驗單位String是檢/試驗樣品的組織機構名稱detectionStandard檢/試驗依據String是檢/試驗樣品所依據的產品標準表5委托受理信息參數（續(xù)）參數名含義類型是否必填項說明sampleReceiveCount收樣數量Float是檢驗單位接收樣品的數量sampleReceiveUnit收樣數量單位String是獨立包裝規(guī)格的單位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報告發(fā)放方式String是電子版自取郵寄其他detectionFee檢驗費用Float否檢驗費用otherFee其他費用Float否其他費用totalFee檢驗總費用Float否檢驗總費用.3檢/試驗記錄參數檢/試驗記錄參數應包含檢/試驗人員信息、檢/試驗設備信息、檢/試驗樣品信息、檢/試驗項目信息、檢/試驗環(huán)境信息。檢/試驗人員信息應符合表6的要求，檢/試驗設備信息應符合表7的要求，檢/5試驗樣品信息應符合表8/試驗項目信息應符合表9/試驗環(huán)境信息應符合表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樣品狀態(tài)String否試驗時樣品狀態(tài)參數名含義類型是否必填項說明detectionItem檢/試驗項目String是檢/試驗項目detectionMethod檢/試驗方法String是檢/試驗項目所規(guī)定的檢/試驗方法detectionValue檢/試驗結果值String是檢/試驗結果值表12檢/試驗設備信息參數表12檢/試驗設備信息參數表13報告信息參數7detectionUnit檢/試驗結果值單位String是標準中規(guī)定的檢/試驗結果值的單位10檢/試驗環(huán)境信息參數參數名含義類型是否必填項說明labName試驗室名稱String是試驗室名稱labEnv試驗室環(huán)境String否試驗室環(huán)境，應根據試驗要求氣壓、照度等。8.3.4報告信息參數//試驗設備1211檢/試驗項目信息參數參數名含義類型是否必填項說明detectionItem檢/試驗項目String是檢/試驗項目detectionMethod檢/試驗方法String是檢/試驗方法detectionResult檢/試驗結果值String是試驗結果值detectionUnit檢/試驗結果值單位String是標準中規(guī)定的檢/試驗結果值的單位standardValue標準值String否標準中規(guī)定的檢/試驗項目的值參數名含義類型是否必填項說明equList檢/試驗使用的設備列表List是檢/7參數名含義類型是否必填項說明reportNumber報告編號String是由檢驗單位賦予檢驗報告的唯一性編號reportConclusion報告結論String是檢驗結論uncertainty測量不確定度Float否測量不確定度detectionCycle檢/試驗日期String是從檢/試驗開始到結束的時間段testerName檢驗人String是檢驗人姓名revieweName報告審核人String是報告審核人姓名表13報告信息參數（續(xù)）參數名含義類型是否必填項說明revieweDate報告審核日期Date是報告審核日期approvalName授權簽字人String是授權簽字人姓名reportApprovalDate報告簽發(fā)日期Date是報告簽發(fā)日期reportPrinter報告打印人String否報告打印人姓名reportPrintDate報告打印日期Date否報告打印日期9接口驗證驗證內容第5章～第8章中的要求，以及環(huán)境要求。驗證環(huán)境驗證環(huán)境應符合運行接口服務所需的操作系統(tǒng)及測試程序軟件。驗證方式驗證方式驗證流程應按照接口文檔規(guī)定的接口名稱和接口參數進行驗證，通信方式應符合第5章的要求，傳輸協(xié)議應符合第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>