ICS03.100.01DB13A02河北省地方標(biāo)準(zhǔn)DB13/T2709—2018法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)庫訪問服務(wù)接口技術(shù)規(guī)范河北省質(zhì)量技術(shù)監(jiān)督局發(fā)布DB13/T2709—2018前言本標(biāo)準(zhǔn)按照GB/T1.1-2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由河北省質(zhì)量技術(shù)監(jiān)督局提出。本標(biāo)準(zhǔn)由河北省服務(wù)標(biāo)準(zhǔn)化技術(shù)委員會（SAHB/TC264）歸口。本標(biāo)準(zhǔn)起草單位：河北省標(biāo)準(zhǔn)化研究院、石家莊宇邦軟件科技有限公司。本標(biāo)準(zhǔn)起草人：閻占輝、董世濤、李虓峰、高龍、于瀟、閆志強、李英君、孫明立、李會、孫家田。IDB13/T2709—2018法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)庫訪問服務(wù)接口技術(shù)規(guī)范1范圍本標(biāo)準(zhǔn)規(guī)定了法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)庫訪問服務(wù)接口（以下簡稱統(tǒng)一代碼接口）的術(shù)語、定義和縮略語、統(tǒng)一代碼接口框架、統(tǒng)一代碼接口要求、統(tǒng)一代碼接口服務(wù)數(shù)據(jù)項和統(tǒng)一代碼接口調(diào)用狀態(tài)信息。本標(biāo)準(zhǔn)適用于政府部門以接口方式進行的統(tǒng)一社會信用代碼數(shù)據(jù)庫信息共享應(yīng)用。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260GB/T4754GB32100中華人民共和國行政區(qū)劃代碼國民經(jīng)濟行業(yè)分類法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則3術(shù)語、定義和縮略語接口interface縮略語1DB13/T2709—2018HTTPS基于安全套接字的超文本傳輸協(xié)議（Securehypertexttransferprotocol）可擴展標(biāo)識語言（Extensiblemarkuplanguage）XMLJSONJS對象標(biāo)記(JavaScriptobjectnotation)4統(tǒng)一代碼接口框架4.1許可和調(diào)用4.1.1接口用戶向接口提供方提交使用申請，用戶申請信息包括：a)機構(gòu)統(tǒng)一社會信用代碼；機構(gòu)名稱；b)c)d)e)用于實現(xiàn)應(yīng)用接口功能的設(shè)備的IP地址；申請使用期限；申請使用數(shù)據(jù)項。4.1.2接口提供方收到申請后，生成許可信息反饋給接口用戶，許可信息包括：a)b)c)d)e)f)g)機構(gòu)統(tǒng)一社會信用代碼；機構(gòu)名稱；用于實現(xiàn)應(yīng)用接口功能的設(shè)備的IP地址；申請使用期限；用戶賬號；接口在接收到請求后，校驗接口用戶許可信息中用于實現(xiàn)應(yīng)用接口功能的設(shè)備的IP地址和申請使用期限的有效性、用戶賬號和用戶密碼的合法性，檢驗通過后，執(zhí)行請求，返回響應(yīng)內(nèi)容。接口用戶接口2DB13/T2709—20185統(tǒng)一代碼接口要求5.1接口定義統(tǒng)一代碼接口定義見表1。表1統(tǒng)一代碼接口定義定義說明StringTydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)1.Tydm_sh_service為約定的接口名稱。2.license為許可參數(shù)(見5.3)。3.4.5.cond_information為條件參數(shù)(見5.4)。repl_packagetype為返回結(jié)果數(shù)據(jù)包格式參數(shù)(見5.5)。接口返回結(jié)果見5.6。5.2基本約定傳輸協(xié)議5.2.1采用HTTPS作為傳輸協(xié)議。5.2.2地址格式接口地址由接口提供方提供，格式為：https://xxx.xxx.xxx.xxx/services_path/service_name。其中：xxx.xxx.xxx.xxx表示接口所在的服務(wù)器的有效地址；services_path表示接口的發(fā)布路徑，由接口提供方命名；service_name表示約定的接口名稱，由接口提供方命名。安全性3DB13/T2709—2018表2許可參數(shù)包體標(biāo)記及含義信息類別標(biāo)記字符類型及長度nvarchar(18)nvarchar(400)nvarchar(8)含義機構(gòu)統(tǒng)一社會信用代碼機構(gòu)名稱說明tydmjgmc------appkeyappsecretip用戶賬號---用戶信息nvarchar(10)nvarchar(15)nvarchar(10)nvarchar(10)用戶密碼---被授權(quán)應(yīng)用接口的設(shè)備的IP地址使用期限開始時間使用期限結(jié)束時間---startdateenddate授權(quán)起始日期授權(quán)終止日期5.3.3包體格式說明許可參數(shù)包體采用JSON格式。許可參數(shù)放置在標(biāo)記{…}之間，見示例1。示例1：{"tydm":"xxxxxxxxxxxxxxxx","jgmc":"xxx",圖2條件參數(shù)4DB13/T2709—2018條件參數(shù)放置在標(biāo)記{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx","value":"xxx"},…,{"field":"xxx","operation":"xxx","value":"xxx"}],"result":"xxx"}之間。exp關(guān)鍵字為條件邏輯關(guān)系。其中與、或分別用*、+標(biāo)識；為空時，默認(rèn)為與；在邏輯關(guān)系中，第一個條件數(shù)據(jù)項用[0]表示，第二個用[1]表示，以此類推，第n個用[n-1]表示，各條件之間可以用圓括號運算符（）組合。fields關(guān)鍵字為條件數(shù)據(jù)項集。其中field關(guān)鍵字為條件數(shù)據(jù)項；operation為條件數(shù)據(jù)項的關(guān)系運算符，其表示及含義見表3；value為條件數(shù)據(jù)項的值。result關(guān)鍵字為返回結(jié)果中用戶要求的數(shù)據(jù)項名稱，各數(shù)據(jù)項間以“,”分隔。數(shù)據(jù)項標(biāo)識應(yīng)符合本標(biāo)準(zhǔn)第6章的規(guī)定。表3關(guān)系運算符表示及含義關(guān)系運算符含義等于說明=字符型按字符編碼順序進行比較數(shù)值型應(yīng)轉(zhuǎn)換成數(shù)值進行比較日期型應(yīng)轉(zhuǎn)換成日期進行比較日期時間型應(yīng)轉(zhuǎn)換成時間進行比較<小于><=大于小于或等于大于或等于不等于模糊匹配左匹配右匹配空值>=<>like僅可應(yīng)用于字符型的數(shù)據(jù)項，從字符串任意位置進行匹配leftlikerightlikeisnullisnotnull僅可應(yīng)用于字符型的數(shù)據(jù)項，從字符串起始端匹配{{{{5DB13/T2709—2018}]"result":"tydm,jgmc,xzqh"}5.55.6返回結(jié)果數(shù)據(jù)包格式參數(shù)接口返回結(jié)果數(shù)據(jù)包格式參數(shù)由接口用戶根據(jù)需要設(shè)定。該參數(shù)取值可為xml或json，不能為空。返回結(jié)果5.6.1內(nèi)容組成返回結(jié)果包括接口調(diào)用狀態(tài)信息、結(jié)果數(shù)據(jù)和結(jié)果集記錄個數(shù)組成。接口調(diào)用失敗時，只返回接口調(diào)用狀態(tài)信息。見圖3。接口調(diào)用狀態(tài)信息結(jié)果數(shù)據(jù)結(jié)果集記錄個數(shù)結(jié)果數(shù)據(jù)記錄1結(jié)果數(shù)據(jù)記錄n??數(shù)據(jù)項1?數(shù)據(jù)項n圖3返回結(jié)果中的接口調(diào)用狀態(tài)和結(jié)果集記錄個數(shù)信息放置在標(biāo)記<RESPDATA>?</RESPDATA>之間,關(guān)鍵字status為調(diào)用狀態(tài)代碼，msg為接口調(diào)用狀態(tài)描述，totalcount為結(jié)果集記錄個數(shù)。接口調(diào)用狀態(tài)代碼和描述應(yīng)符合本標(biāo)準(zhǔn)第7章的規(guī)定。結(jié)果數(shù)據(jù)置于標(biāo)記<ROWDATA>?</ROWDATA>之間。結(jié)果數(shù)據(jù)不同記錄間用<ROW…/>?<ROW…/>分隔。數(shù)據(jù)項標(biāo)識應(yīng)符合本標(biāo)準(zhǔn)第6章的規(guī)定。<?xmlversion="1.0"encoding="UTF-8"?><DATAPACKETVersion="2.0"><RESPDATA>6DB13/T2709—2018</ROWDATA></DATAPACKET>JSON格式返回結(jié)果信息放置在標(biāo)記{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},"rowdata":[{xxx},…,{xxx}]}之間。在respdata標(biāo)簽內(nèi)，關(guān)鍵字status為接口調(diào)用狀態(tài)代碼，msg為接口調(diào)用狀態(tài)描述，totalcount為結(jié)果集記錄個數(shù)。接口調(diào)用狀態(tài)代碼和描述應(yīng)符合本標(biāo)準(zhǔn)第7章的規(guī)定。在rowdata標(biāo)簽內(nèi)，每條結(jié)果數(shù)據(jù)記錄放置在標(biāo)記{…}之間。數(shù)據(jù)記錄中的數(shù)據(jù)項標(biāo)識應(yīng)符合本標(biāo)準(zhǔn)第6章的規(guī)定。返回結(jié)果包體JSON格式見示例4。示例4：{"respdata":{"status":"0","msg":"調(diào)用成功","totalcount":"2"}，"rowdata":[{"tydm":"XXXXXXXXXXXXXXXXXX","jgmc":"河北省XXX股份有限公司"，"xzqh":"XXXXXX""tydm":"XXXXXXXXXXXXXXXXXX","jgmc":"石家莊市XXX股份有限公司","xzqh":"XXXXXX"]}6表4接口服務(wù)數(shù)據(jù)項7DB13/T2709—2018表4接口服務(wù)數(shù)據(jù)項（續(xù)）數(shù)據(jù)項標(biāo)識含義數(shù)據(jù)類型及長度說明lxdh聯(lián)系電話nvarchar(50)---clrq登記成立日期Datetime---djztgxrq登記狀態(tài)nvarchar(2)Datetime0：新辦，1：變更，2：注銷最后更新日期---7統(tǒng)一代碼接口調(diào)用狀態(tài)信息接口調(diào)用狀態(tài)信息包括接口狀態(tài)代碼及接口狀態(tài)描述，詳見表5。表5接口調(diào)用狀態(tài)代碼及接口調(diào)用狀態(tài)描述接口狀態(tài)代碼接口狀態(tài)描述0調(diào)用成功1調(diào)用失敗被授權(quán)應(yīng)用接口的設(shè)備IP地址錯誤條件參數(shù)錯誤-100-130返回結(jié)果數(shù)據(jù)包格式參數(shù)錯誤數(shù)據(jù)庫錯誤8DB13/T2709—2018附錄A（資料性附錄）統(tǒng)一代碼接口調(diào)用方法實例A.1實例說明在本實例中，設(shè)定統(tǒng)一代碼接口地址為：:8082/dso/Tydm_sh_service；接口用戶的機構(gòu)統(tǒng)一社會信用代碼為：111300004017053009，機構(gòu)名稱為：河北省標(biāo)準(zhǔn)化研究院；通過接口查詢的數(shù)據(jù)條件是：機構(gòu)名稱中包含“標(biāo)準(zhǔn)”且包含“研究院”的機構(gòu)；返回結(jié)果包體是：json格式，結(jié)果數(shù)據(jù)項包括：統(tǒng)一代碼、機構(gòu)名稱、法定代表人或負(fù)責(zé)人、機構(gòu)地址、經(jīng)營范圍、聯(lián)系電話、成立日期、所屬經(jīng)濟行業(yè)代碼,行政區(qū)劃代碼、登記狀態(tài)、最后更新日期。A.2實例程序代碼本實例以java語言實現(xiàn)，程序代碼如下：packagetestjgdm;//包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm{//定義類jgdmStringstrkey2="研究院";//查詢關(guān)鍵字2try{e1.printStackTrace();//構(gòu)建許可參數(shù)licencequerys.put("licence","{\"tydm\":\""+tydm+"\",\"jgmc\":\""+jgmc+"\",\"appkey\":\""+appkey+"\",\"appsecret\":\""+appsecret+"\",\"ip\":\""+ip+"\",\"startdate\":\""+startdate+"\",\"enddate\":\""+enddate+"\"}");9DB13/T2709—2018//構(gòu)建條件參數(shù)cond_informationquerys.put("cond_information","{\"exp\":\"[0]*[1]\",\"result\":\"tydm，jgmc，fddbr,jgdz,jyfw,lxdh,clrq,sshy,xzqh,djzt,gxrq\",\"fields\":[{\"field\":\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey+"\"},{\"field\":\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey2+"\"}]}");try{//向接口提交請求HttpRespon