DB6101T 3188-2024 檢驗檢測數(shù)據(jù)管理規(guī)范 數(shù)據(jù)接口

ICS35.020CCSL706101IDB6101/T3188—2024 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5接口通信 通信方式 通信要求 6接口傳輸 2傳輸協(xié)議 2傳輸內(nèi)容 27接口格式 28接口報文 2報文結(jié)構(gòu) 2報文頭 2報文體 29接口驗證 8驗證內(nèi)容 8驗證環(huán)境 8驗證方式 8附錄A（資料性）報文信息JSON結(jié)構(gòu)示例 9附錄B（資料性）報文信息XML結(jié)構(gòu)示例 DB6101/T3188—2024本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責任。本文件由西安市市場監(jiān)督管理局提出并歸口。本文件起草單位：瑞特認證檢測集團有限公司、陜西瑞智信息技術(shù)有限公司、中鐵一局集團有限公司、陜西漢通建設工程質(zhì)量檢測有限公司、陜西省建筑工程質(zhì)量檢測中心有限公司、西安市質(zhì)量與標準化研究院、陜西北佳信息技術(shù)有限責任公司、國網(wǎng)陜西省電力公司西安供電公司、湖北鐵建工程檢測有限公司。本文件主要起草人：王暉、周強、祝凱、暢亞文、張源、劉欣、王彬彬、曹珺溥、胡亞芹、王佩、張琛、王雨潤、王磊、荀漪、郭丹。本文件由瑞特認證檢測集團有限公司負責解釋。本文件首次發(fā)布。本文件在實施過程中如有疑問或建議，請將咨詢或修改建議等信息反饋至下列單位:單位：瑞特認證檢測集團有限公司地址：陜西省西安市藍田縣華胥鎮(zhèn)西北家具工業(yè)園新港七路8號電話編：7105231DB6101/T3188—2024檢驗檢測數(shù)據(jù)管理規(guī)范數(shù)據(jù)接口本文件規(guī)定檢驗檢測數(shù)據(jù)管理的數(shù)據(jù)接口通信、接口傳輸、接口格式、接口報文和接口驗證的要求。本文件適用于西安市檢驗檢測數(shù)據(jù)管理的數(shù)據(jù)接口要求。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T7408.1日期和時間信息交換表示法第1部分：基本原則DB6101/T3182—2024檢驗檢測數(shù)據(jù)管理規(guī)范數(shù)據(jù)元3術(shù)語和定義本文件沒有需要界定的術(shù)語和定義。4縮略語下列縮略語適用于本文件。FTP:文件傳輸協(xié)議（FileTransferProtocol）HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）HTTPS：超文本安全傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）IP：網(wǎng)絡之間互聯(lián)的協(xié)議(InternetProtocol)JSON：JavaScript對象表示法(JavaScriptObjectNotation）URL：統(tǒng)一資源定位符(UniformResourceLocator)XML：可擴展標記語言（ExtensibleMarkupLanguage）5接口通信通信方式應明確通信方式，適用時包括：同步應答、異步應答、廣播通知、文件傳輸?shù)?。通信要求采用不同的通信方式時，應符合：——同步應答時，發(fā)起方向接收方發(fā)送檢驗檢測數(shù)據(jù)請求，發(fā)送方等待接收方處理結(jié)果，接收方應處理，并返回處理結(jié)果；——異步應答時，發(fā)起方向接收方發(fā)送檢驗檢測數(shù)據(jù)請求，發(fā)起方不再等待接收方處理結(jié)果，由接收方處理完成后向發(fā)起方發(fā)送回執(zhí)；23DB6101/T3188—2024委托信息參數(shù)應包含委托方信息、委托樣品信息、檢/試驗要求信息、檢/試驗項目信息。委托方信息應符合表1的要求，委托樣品信息應符合表2的要求，檢/試驗要求信息應符合表3的要求，檢/試驗項目信息應符合表4的要求。表1委托方信息參數(shù)是是是否表2委托樣品信息參數(shù)是否是是是是是是否否是否是是4DB6101/T3188—2024表2委托樣品信息參數(shù)（續(xù)）是否表3檢/試驗要求信息參數(shù)是是是表4檢/試驗項目信息參數(shù)是是法8.3.2委托受理信息參數(shù)委托受理信息參數(shù)應符合表5的要求。表5委托受理信息參數(shù)是是是是是是5DB6101/T3188—2024表5委托受理信息參數(shù)（續(xù)）是是否否否否否否是是期否否否是是否否否8.3.3檢/試驗記錄參數(shù)檢/試驗記錄參數(shù)應包含檢/試驗人員信息、檢/試驗設備信息、檢/試驗樣品信息、檢/試驗項目信息、檢/試驗環(huán)境信息。檢/試驗人員信息應符合表6的要求，檢/試驗設備信息應符合表7的要求，檢/6DB6101/T3188—2024試驗樣品信息應符合表8的要求，檢/試驗項目信息應符合表9的要求，檢/試驗環(huán)境信息應符合表10的要表6檢/試驗人員信息參數(shù)是是否是是否是表7檢/試驗設備信息參數(shù)是是表8檢/試驗樣品信息參數(shù)是是是否表9檢/試驗項目信息參數(shù)是是是7DB6101/T3188—2024是表10檢/試驗環(huán)境信息參數(shù)是否8.3.4報告信息參數(shù)報告信息參數(shù)應包含委托方信息、委托樣品信息、委托受理信息、檢/試驗項目信息、檢/試驗設備信息，報告信息。委托方信息應符合表1的要求，委托樣品信息應符合表2的要求，委托受理信息應符合表5的要求，檢/試驗項目信息應符合表11的要求，檢/試驗設備信息應符合表12的要求，報告信息應符合表13的要求。表11檢/試驗項目信息參數(shù)是是是是否值表12檢/試驗設備信息參數(shù)是表13報告信息參數(shù)是是否是段8DB6101/T3188—2024是是表13報告信息參數(shù)（續(xù)）是是是否否9接口驗證驗證內(nèi)容第5章～第8章中的要求，以及環(huán)境要求。驗證環(huán)境驗證環(huán)境應符合運行接口服務所需的操作系統(tǒng)及測試程序軟件。驗證方式驗證流程應按照接口文檔規(guī)定的接口名稱和接口參數(shù)進行驗證，通信方式應符合第5章的要求，傳輸協(xié)議應符合第6章的要求，接口的報文數(shù)據(jù)應符合第7章、第8章的要求。9DB6101/T3188—2024（資料性）報文信息JSON結(jié)構(gòu)示例下面給出了JSON結(jié)構(gòu)的報文信息示例。請求示例：Method:GETPath:/getReportInfoByNumberContent-Type:application/json;charset=UTF-8Host:Token:tokenTimestamp:1686980240{"reportNumber":"RCD2023（B）01010001"}{"message":"請求成功","timestamp":"1686980250","customerName":"委托方","customerContact":"委托人","customePhone":"159****1234","sampleName":"背貼式橡膠止水帶","sampleModel":"背貼式橡膠止水帶350mm×8mm","sampleTrademark":"樣品商標","sampleProduce":"生產(chǎn)單位",......}DB6101/T3188—2024報文信息XML結(jié)構(gòu)示例下面給出了XML結(jié)構(gòu)的報文信息示例。請求示例：<?xmlversion="1.0"encoding="UTF-8"?><request><Method>GET</Method><Path>/getReportInfoByNumber</Path><Content-Type>application/json;charset=UTF-8</Content-Type><Host></Host><Token>token</Token><Timestamp>1686980240</Timestamp><Data><reportNumber>RCD2023（B）01010001</reportNumber></Data></request>響應示例：<?xmlversion="1.0":encoding="UTF-8"?><root><code>200</code><message>請求成功</message><timestamp>1686980250</timestamp><data><customerName>委托方</customerName><customerContact>委托人</customerContact><customerPhone>159****1234</customerPhone><sampleName>背貼式橡膠止水帶</sampleName><sampleModel>背貼式橡膠止水帶350mm×8mm</sampleModel>