用于微博客的組織機(jī)構(gòu)代碼實(shí)名認(rèn)證服務(wù)接口規(guī)范

ICSFORMTEXT35.040FORMTEXTA00中華人民共和國國家標(biāo)準(zhǔn)GB/TFORMTEXTXXXXX—FORMTEXTXXXXFORMTEXTFORMTEXT用于微博客的組織機(jī)構(gòu)代碼實(shí)名認(rèn)證服務(wù)接口規(guī)范ServiceinterfacespecificationforMicroBlogoforgnizationcode（征求意見稿）FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX發(fā)布FORMTEXTXXXX-FORMTEXTXX-FORMTEXTXX實(shí)施GB/TXXXXX-2015用于微博客的組織機(jī)構(gòu)代碼實(shí)名認(rèn)證服務(wù)接口規(guī)范目??次前言 錯(cuò)誤！未定義書簽。引言 III1范圍 42規(guī)范性引用文件 43術(shù)語和定義 44服務(wù)接口 5附錄A 10

引??言本標(biāo)準(zhǔn)詳細(xì)描述了組織機(jī)構(gòu)代碼管理中心向微博客商業(yè)網(wǎng)站提供組織機(jī)構(gòu)微博客實(shí)名信息對(duì)比的要求，主要包括接口調(diào)用、數(shù)據(jù)定義、數(shù)據(jù)加密等要求。組織機(jī)構(gòu)代碼作為組織機(jī)構(gòu)的“身份證”，通過使用組織機(jī)構(gòu)代碼庫信息用于微博客實(shí)名認(rèn)證，無論對(duì)微博客網(wǎng)站、組織機(jī)構(gòu)來說都有重要的意義，是深化微博客實(shí)名制應(yīng)用，以促進(jìn)微博健康發(fā)展的關(guān)鍵。用于微博客的組織機(jī)構(gòu)代碼實(shí)名認(rèn)證服務(wù)接口規(guī)范范圍本標(biāo)準(zhǔn)規(guī)定了用于微博客組織機(jī)構(gòu)代碼服務(wù)接口的格式規(guī)范，詳細(xì)定義了微博客商業(yè)網(wǎng)站訪問組織機(jī)構(gòu)代碼信息資源的接口要求，包括：接口調(diào)用、數(shù)據(jù)加密要求、格式要求、數(shù)據(jù)類型定義等。本標(biāo)準(zhǔn)適用于所有訪問組織機(jī)構(gòu)代碼信息的微博客商業(yè)網(wǎng)站在接受組織機(jī)構(gòu)微博帳戶注冊(cè)時(shí)，進(jìn)行信息對(duì)比認(rèn)證的過程。本標(biāo)準(zhǔn)所使用的術(shù)語定義及數(shù)據(jù)元素僅限于本標(biāo)準(zhǔn)。規(guī)范性引用文件下列文件中的條款通過本標(biāo)準(zhǔn)的應(yīng)用而成為本標(biāo)準(zhǔn)的的條款。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T11714-1997全國組織機(jī)構(gòu)代碼編制規(guī)則GB/T18793-2002信息技術(shù)可擴(kuò)展置標(biāo)語言（XML）1.0GB/T7408-2005數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法術(shù)語和定義微博客MicroBlog一種通過關(guān)注機(jī)制分享咨詢的廣播式的社交網(wǎng)絡(luò)平臺(tái)。微博客網(wǎng)站Micro

Blog

Website承載微博客系統(tǒng)的門戶網(wǎng)站。組織機(jī)構(gòu)Organization指中華人民共和國內(nèi)依法注冊(cè)、依法登記的機(jī)關(guān)、企、事業(yè)單位、社會(huì)團(tuán)體，以及其他類型組織。組織機(jī)構(gòu)代碼Organizationcode對(duì)中華人民共和國內(nèi)依法注冊(cè)、依法登記的機(jī)關(guān)、企、事業(yè)單位、社會(huì)團(tuán)體，以及其他組織機(jī)構(gòu)頒發(fā)一個(gè)在全國范圍內(nèi)唯一的、始終不變的代碼標(biāo)識(shí)。按照強(qiáng)制性國家標(biāo)準(zhǔn)GB11714《全國組織機(jī)構(gòu)代碼編制規(guī)則》編制，由八位數(shù)字(或大寫拉丁字母)本體代碼和一位數(shù)字(或大寫拉丁字母)校驗(yàn)碼組成。組織機(jī)構(gòu)代碼庫OrgnizationCodeDatabase全國組織機(jī)構(gòu)代碼中心及其分中心對(duì)于組織機(jī)構(gòu)管理過程所產(chǎn)生的數(shù)據(jù)。服務(wù)接口Serviceinterface計(jì)算機(jī)軟件系統(tǒng)之間進(jìn)行共享數(shù)據(jù)、交換信息的支持程序，以電子文件的形式實(shí)現(xiàn)。WSDLWebServicesDescriptionLanguageWSDL是一種XML應(yīng)用，它將Web服務(wù)描述定義為一組服務(wù)訪問點(diǎn)，使用者可以通過這些服務(wù)訪問點(diǎn)對(duì)包含面向文檔信息或面向過程調(diào)用的服務(wù)進(jìn)行訪問。服務(wù)接口實(shí)名備案接口接口定義實(shí)名備案：publicStringrecordDMInfo(StringoperatorCode,StringopInfo)；調(diào)用時(shí)需完全吻合方法名稱的大小寫、請(qǐng)求參數(shù)個(gè)數(shù)、請(qǐng)求參數(shù)的位置和請(qǐng)求參數(shù)類型。接口參數(shù)說明接口參數(shù)序號(hào)參數(shù)名數(shù)據(jù)類型描述1operatorCodeString微博客運(yùn)營商實(shí)名備案申請(qǐng)表中組織機(jī)構(gòu)代碼證號(hào)，省略連字符（-）。2opInfoString規(guī)定格式的XML標(biāo)準(zhǔn)字符串。XML格式規(guī)范說明實(shí)名備案請(qǐng)求opInfo<?xmlversion="1.0"encoding="UTF-8"?><record><WZMC>網(wǎng)站名稱</WZMC><WZYM>網(wǎng)站域名</WZYM><ZZJGMC>申請(qǐng)單位名稱</ZZJGMC><FDDBR>法定代表人姓名</FDDBR><ZJHM>法人證件</ZJHM><SQR>申請(qǐng)人姓名</SQR><SQR_ZJHM>申請(qǐng)人證件號(hào)碼</SQR_ZJHM><MEMO>備用字段</MEMO></record>實(shí)名備案返回recordDMInfo<?xmlversion="1.0"encoding="UTF-8"?><record><BAZT>備案狀態(tài)</BAZT><ZTSM>備案狀態(tài)說明</ZTSM><BAH>備案號(hào)</BAH><WZYM>網(wǎng)站域名</WZYM><MEMO>備用字段</MEMO></record>實(shí)名認(rèn)證接口接口定義實(shí)名認(rèn)證：publicStringverifyDMInfo(StringcompanyCode,StringdmInfo)；調(diào)用時(shí)需完全吻合方法名稱的大小寫、請(qǐng)求參數(shù)個(gè)數(shù)、請(qǐng)求參數(shù)的位置和請(qǐng)求參數(shù)類型。接口參數(shù)說明接口參數(shù)序號(hào)參數(shù)名數(shù)據(jù)類型描述1companyCodeString微博客網(wǎng)站接收組織機(jī)構(gòu)類用戶申請(qǐng)微博客賬號(hào)的申請(qǐng)表中填寫的9位組織機(jī)構(gòu)代碼，省略連字符（-）。2dmInfoString規(guī)定格式的XML標(biāo)準(zhǔn)字符串。XML格式規(guī)范說明實(shí)名認(rèn)證請(qǐng)求dmInfo<?xmlversion="1.0"encoding="UTF-8"?><verify><WBWZBM>組織機(jī)構(gòu)微博帳戶</WBWZBM><ZZJGDM>組織機(jī)構(gòu)代碼</ZZJGDM><ZZJGMC>組織機(jī)構(gòu)名稱</ZZJGMC><FDDBR>法定代表人姓名</FDDBR><ZJHM>法人證件</ZJHM><SQR>申請(qǐng)人姓名</SQR><SQR_ZJHM>申請(qǐng)人證件號(hào)碼</SQR_ZJHM><MEMO>備用字段</MEMO></verify>實(shí)名認(rèn)證返回verifyDMInfo<?xmlversion="1.0"encoding="UTF-8"?><VERIFY><FHBM>請(qǐng)求返回狀態(tài)碼</FHBM><JGSM>狀態(tài)碼說明信息</JGSM><BDHZM>比對(duì)回執(zhí)碼</BDHZM><WBWZBH>組織機(jī)構(gòu)微博帳戶</WBWZBH><MEMO>備用字段</MEMO></VERIFY>冒用申訴接口接口定義冒用申訴：publicStringappealDMInfo(StringappealCode,StringapInfo)；調(diào)用時(shí)需完全吻合方法名稱的大小寫、請(qǐng)求參數(shù)個(gè)數(shù)、請(qǐng)求參數(shù)的位置和請(qǐng)求參數(shù)類型。接口參數(shù)說明接口參數(shù)序號(hào)參數(shù)名數(shù)據(jù)類型描述1appealCodeString微博客網(wǎng)站接收組織機(jī)構(gòu)類用戶申訴微博客賬號(hào)被冒用的申請(qǐng)表中填寫的9位組織機(jī)構(gòu)代碼，省略連字符（-）。2apInfoString規(guī)定格式的XML標(biāo)準(zhǔn)字符串。XML格式規(guī)范說明冒用申訴請(qǐng)求apInfo<?xmlversion="1.0"encoding="UTF-8"?><appeal><WBWZBM>組織機(jī)構(gòu)微博帳戶</WBWZBM><ZZJGDM>組織機(jī)構(gòu)代碼</ZZJGDM><ZZJGMC>組織機(jī)構(gòu)名稱</ZZJGMC><FDDBR>法定代表人姓名</FDDBR><ZJHM>法人證件</ZJHM><SQR>申請(qǐng)人姓名</SQR><SQR_ZJHM>申請(qǐng)人證件號(hào)碼</SQR_ZJHM><MEMO>備用字段</MEMO></appeal>冒用申訴返回appealDMInfo<?xmlversion="1.0"encoding="UTF-8"?><appeal><FHBM>請(qǐng)求返回狀態(tài)碼</FHBM><JGSM>狀態(tài)碼說明信息</JGSM><BDHZM>比對(duì)回執(zhí)碼</BDHZM><WBWZBH>組織機(jī)構(gòu)微博帳戶</WBWZBH><MEMO>備用字段</MEMO></appeal>數(shù)據(jù)定義請(qǐng)求信息請(qǐng)求信息數(shù)據(jù)類型定義見下表。請(qǐng)求信息表節(jié)點(diǎn)名稱中文名稱含義說明數(shù)據(jù)類型值域WZMC網(wǎng)站名稱微博客運(yùn)營商的網(wǎng)站名稱字符串必填項(xiàng)，長(zhǎng)度限制在130字符內(nèi)，加密WZYM網(wǎng)站域名微博客運(yùn)營商的網(wǎng)站域名字符串必填項(xiàng)，長(zhǎng)度限制在130字符內(nèi)，加密WBWZBH組織機(jī)構(gòu)微博帳戶組織機(jī)構(gòu)在商業(yè)網(wǎng)站申請(qǐng)的微博帳戶。字符串必填項(xiàng)，長(zhǎng)度限制在50字符內(nèi)，加密JGDM組織機(jī)構(gòu)代碼申請(qǐng)微博帳戶關(guān)聯(lián)的組織機(jī)構(gòu)代碼。字符串必填項(xiàng)，長(zhǎng)度為9字符，符合GB/T11714-1997，加密JGMC組織機(jī)構(gòu)名稱申請(qǐng)微博帳戶關(guān)聯(lián)的組織機(jī)構(gòu)名稱。字符串必填項(xiàng)，長(zhǎng)度限制在130字符內(nèi)，加密FDDBR法定代表人姓名申請(qǐng)微博帳戶關(guān)聯(lián)的組織機(jī)構(gòu)法人姓名字符串必填項(xiàng)，長(zhǎng)度限制在130字符內(nèi)，加密ZJHM法人證件申請(qǐng)微博帳戶關(guān)聯(lián)的法人證件號(hào)碼字符串必填項(xiàng)，長(zhǎng)度限制在50字符內(nèi)，加密SQR申請(qǐng)人姓名組織機(jī)構(gòu)微博帳戶申請(qǐng)人姓名字符串必填項(xiàng)，長(zhǎng)度限制在130字符內(nèi)，加密SQR_ZJHM申請(qǐng)人證件號(hào)碼組織機(jī)構(gòu)微博帳戶申請(qǐng)人有效身份證件號(hào)碼字符串必填項(xiàng)，長(zhǎng)度限制在50字符內(nèi)，加密MEMO備用字段擴(kuò)展位，備用字符串非必填，為空時(shí)項(xiàng)節(jié)點(diǎn)保留，長(zhǎng)度限制在120字符內(nèi)，非空時(shí)加密比對(duì)結(jié)果指全國組織機(jī)構(gòu)代碼中心數(shù)據(jù)服務(wù)利用微博客網(wǎng)站傳遞的對(duì)比信息與組織機(jī)構(gòu)代碼庫信息進(jìn)行對(duì)比，返回比對(duì)結(jié)果，數(shù)據(jù)類型定義見表5。比對(duì)結(jié)果英文名稱中文名稱含義數(shù)據(jù)類型值域BAZT備案狀態(tài)微博客運(yùn)營商申請(qǐng)備案的狀態(tài)字符串必填項(xiàng)，長(zhǎng)度限制在10字符內(nèi)，加密ZTSM備案狀態(tài)說明備案狀態(tài)的原因說明字符串必填項(xiàng)，長(zhǎng)度限制在150字符內(nèi)，加密BAH備案號(hào)微博客運(yùn)營商備案號(hào)字符串必填項(xiàng)，長(zhǎng)度限制在50字符內(nèi)，加密FHBM請(qǐng)求返回狀態(tài)碼微博商業(yè)網(wǎng)站請(qǐng)求服務(wù)后返回的比對(duì)結(jié)果。字符串必填項(xiàng)，長(zhǎng)度為2位，加密JGSM狀態(tài)碼說明信息微博商業(yè)網(wǎng)站請(qǐng)求服務(wù)后返回的比對(duì)結(jié)果的詳細(xì)說明。字符串必填項(xiàng)，長(zhǎng)度限制為130位，加密BDHZM比對(duì)回執(zhí)碼當(dāng)比對(duì)結(jié)果一致時(shí)，由代碼中心服務(wù)器生成的與組織機(jī)構(gòu)唯一對(duì)應(yīng)的回執(zhí)碼；當(dāng)比對(duì)結(jié)果不一致時(shí)為空值。字符串選填項(xiàng)，長(zhǎng)度限制為100位，非空時(shí)加密WBWZBH組織機(jī)構(gòu)微博帳戶字符串必填項(xiàng)，長(zhǎng)度限制為50位，加密MEMO備用字段字符串非必填項(xiàng)，為空時(shí)節(jié)點(diǎn)保留，長(zhǎng)度限制在120字符內(nèi)，加密狀態(tài)碼表指比對(duì)結(jié)果中請(qǐng)求返回狀態(tài)碼字段的說明，見下表。狀態(tài)碼表狀態(tài)碼含義0信息匹配一致1信息匹配不一致2代碼證書不在有效期3代碼證書已失效-1系統(tǒng)異常-2服務(wù)器IP校驗(yàn)失敗-3companyCode無效-4XML結(jié)構(gòu)不完整-5xxx節(jié)點(diǎn)值A(chǔ)ES解密錯(cuò)誤-6xxx必填項(xiàng)節(jié)點(diǎn)為空值

附錄A（資料性附錄）數(shù)據(jù)加密要求數(shù)據(jù)傳輸過程中使用AES加密算法對(duì)數(shù)據(jù)進(jìn)行加密，接口返回值為AES加密后字符串。使用代碼中心提供的密鑰解密，加密算法的示例如下：JAVA語言的加解密代碼示例importjavax.crypto.Cipher;importjavax.crypto.spec.SecretKeySpec;publicclassArithmetic{ publicstaticSecretKeySpecgetKey(Stringseed){ SecretKeySpeckey=null; try{ key=newSecretKeySpec(hex2byte(seed.getBytes()),"AES"); }catch(Exceptione){ e.printStackTrace(); } returnkey; } /** *加密String明文輸入,String密文輸出 *@paramstrMing *@return */ publicstaticStringgetEncString(StringstrMing,Stringseed){ byte[]byteMi=null; byte[]byteMing=null; StringstrMi=""; try{ returnbyte2hex(getEncCode(strMing.getBytes(),seed)); }catch(Exceptione){ e.printStackTrace(); }finally{ byteMing=null; byteMi=null; } returnstrMi; } /** *解密以String密文輸入,String明文輸出 *@paramstrMi *@return */ publicstaticStringgetDesString(StringstrMi,Stringseed){ byte[]byteMing=null; byte[]byteMi=null; StringstrMing=""; try{ returnnewString(getDesCode(hex2byte(strMi.getBytes()),seed)); }catch(Exceptione){ e.printStackTrace(); }finally{ byteMing=null; byteMi=null; } returnstrMing; } /** *加密以byte[]明文輸入,byte[]密文輸出 *@parambyteS *@return */ privatestaticbyte[]getEncCode(byte[]byteS,Stringseed){ SecretKeySpeckey=getKey(seed); byte[]byteFina=null; Ciphercipher; try{ cipher=Cipher.getInstance("AES/ECB/PKCS5Padding"); cipher.init(Cipher.ENCRYPT_MODE,key); byteFina=cipher.doFinal(byteS); }catch(Exceptione){ e.printStackTrace(); }finally{ cipher=null; } returnbyteFina; } /** *解密以byte[]密文輸入,以byte[]明文輸出 *@parambyteD *@return */ privatestaticbyte[]getDesCode(byte[]byteD,Stringseed){ SecretKeySpeckey=getKey(seed); Ciphercipher; byte[]byteFina=null; try{ cipher=Cipher.getInstance("AES/ECB/PKCS5Padding"); cipher.init(Cipher.DECRYPT_MODE,key); byteFina=cipher.doFinal(byteD); }catch(Exceptione){ e.printStackTrace(); }finally{ cipher=null; } returnbyteFina; } /** *二行制轉(zhuǎn)字符串 *@paramb *@return */ publicstaticStringbyte2hex(byte[]b){//一個(gè)字節(jié)的數(shù)， //轉(zhuǎn)成16進(jìn)制字符串 Stringhs=""; Stringstmp=""; for(intn=0;n<b.length;n++){ //整數(shù)轉(zhuǎn)成十六進(jìn)制表示 stmp=(Integer.toHexString(b[n]&0XFF)); if(stmp.length()==1) hs=hs+"0"+stmp; else hs=hs+stmp; } returnhs.toUpperCase();//轉(zhuǎn)成大寫 } publicstaticbyte[]hex2byte(byte[]b){ if((b.length%2)!=0) thrownewIllegalArgumentException("長(zhǎng)度不是偶數(shù)"); byte[]b2=newbyte[b.length/2]; for(intn=0;n<b.length;n+=2){ Stringitem=newString(b,n,2); //兩位一組，表示一個(gè)字節(jié),把這樣表示的16進(jìn)制字符串，還原成一個(gè)進(jìn)制字節(jié) b2[n/2]=(byte)Integer.parseInt(item,16); } returnb2; } publicstaticvoidmain(String[]args){ Stringseed="B4DA0006EA6C5EAAF742D4161E01FDC1"; Stringtest1=Arithmetic.getEncString("明文字符串",seed);// System.out.println("sss:"+test1); Stringtest2=Arithmetic.getDesString(test1,seed); System.out.println("ttt:"+tes