《用于微博客的组织机构代码实名认证服务接口规范.docx》由会员分享,可在线阅读,更多相关《用于微博客的组织机构代码实名认证服务接口规范.docx(16页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、ICS 35. 040A00中华人民共和OBI家标准GB/T XXXXXXXXX用于微博客的组织机构代码实名认证服务接口规范Service interface specification for MicroBlog of orgnization code(征求意见稿)XXXX - XX - XX 实施XXXX - XX - XX 发布中华人民共和国国家质量监督检验检疫总局国家标准化管理委员会BAH备案号微博客运营商备案号字符串必填项,长度限制在50 字符内,加密FHBM请求返回状态码微博商业网站请求服 务后返回的比对结果。字符串必填项,长度为2位,加 密JGSM状态码说明信息微博商业网站请求服
2、 务后返回的比对结果 的详细说明。字符串必填项,长度限制为1度 位,加密BDHZM比对回执码当比对结果一致时,由 代码中心服务器生成 的与组织机构唯一对 应的回执码;当比对结 果不一致时为空值。字符串选填项,长度限制为100 位,非空时加密WBWZBH组织机构微博帐 户字符串必填项,长度限制为50 位,加密MEMO备用字段字符串非必填项,为空时节点保 留,长度限制在120字符 内,加密C)状态码表指比对结果中请求返回状态码字段的说明,见下表。表12状态码表状态码含义0信息匹配一致1信息匹配不一致2代码证书不在有效期3代码证书已失效-1系统异常-2服务器IP校验失败-3companyCode 无
3、效-4XML结构不完整-5xxx节点值AES解密错误-6XXX必填项节点为空值附录A(资料性附录)数据加密要求数据传输过程中使用AES加密算法对数据进行加密,接口返回值为AES加密后字符串。使用 代码中心提供的密钥解密,加密算法的示例如下:a) JAVA语言的加解密代码示例import javax. crypto. Cipher;import javax. crypto, spec. SecretKeySpec;public class Arithmetic public static SecretKeySpec getKey(String seed) SecretKeySpec key =
4、null;try key = new SecretKeySpec(hex2byte(seed. getBytes(), AES); catch (Exception e) e.printStackTrace();return key;)/* 加密String明文输入,String密文输出* param strMing* return*/public static String getEncString(String strMing, String seed) byte byteMi 二 null;byte byteMing = null;String strMi 二;try (return b
5、yte2hex (getEncCode (strMing. getBytes(), seed); catch (Exception e) e. printStackTrace (); finally byteMing = null;byteMi = null;) return strMi;) /* 解密 以String密文输入,String明文输出* param strMi* return* /public static String getDesString(String strMi, String seed) byte byteMing = null;byte byteMi = null;
6、String strMing = ; try (return new String (getDesCode(hex2byte(strMi. getBytes(), seed); catch (Exception e) e. printStackTrace (); finally byteMing = null;byteMi = null; return strMing;* 加密以byte口明文输入,byte口密文输出* param byteS* return* /private static byte getEncCode(byte byteS, String seed) SecretKeyS
7、pec key = getKey (seed);byte byteFina = null;Cipher cipher;try (cipher = Cipher.getlnstance(AES/ECB/PKCSSPadding); cipher, init (Cipher. ENCRYPTJ10DE, key);byteFina = cipher. doFinal(byteS); catch (Exception e) e.printStackTrace(); finally cipher = null;)return byteFina;)/* 解密以byte密文输入,以byte口明文输出* p
8、aram byteD* return* /private static byte getDesCode(byte byteD, String seed) SecretKeySpec key = getKey (seed);Cipher cipher;byte byteFina = null;try (cipher = Cipher, getlnstance (,/AES/ECB/PKCS5Padding,/); cipher, init (Cipher. DECRYPT MODE, key);byteFina 二cipher. doFinal(byteD); catch (Exception
9、e) e.printStackTrace(); finally cipher = null;return byteFina;/* 二行制转字符串* param b* returnpublic static String byte2hex(byte b) / 一个字节的数,/转成16进制字符串String hs 二;String stmp 二;for (int n = 0; n b.length; n+) /整数转成十六进制表示stmp = (Integer.toHexString(bn & OXFF);if (stmp. length () = 1)hs = hs + 0 + stmp;els
10、ehs = hs + stmp;)return hs. toUpperCase () ; / 转成大写public static byte hex2byte(byte b) if (b.length % 2) != 0)throw new HlegalArgumentException(长度不是偶数);byte b2 = new byteb. length / 2;for (int n = 0; n key);$pad = 16 - (strlen($text) % 16);$text .= str_repeat(chr($pad), $pad);returnbin2hex (mcrypt_e
11、ncrypt(MCRYPTRIJNDAEL_128,$key, $text,MCRYPT MODE_ECB);)/* *实现AES解密* $crypttext :要解密的字符串*/function decryptString($crypttext)$key = pack(H*, $this-key);Scrypttext = pack(II*,$crypttext);$text = mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $key, Scrypttext, MCRYPT_MODE_ECB);$pad = 16 - (strlen ($text) % 16);$t
12、ext .= str_repeat(chr($pad), $pad); return $text;)刖 B本标准的附录A、附录B为资料性附录。本标准由全国信息分类与编码标准化技术委员会提出并归口;本标准的起草单位:全国组织机构代码管理中心。本标准的主要起草人:。刖 百本标准的附录A、附录B为资料性附录。本标准由全国信息分类与编码标准化技术委员会提出并归口;本标准的起草单位:全国组织机构代码管理中心。本标准的主要起草人:。刖 百本标准的附录A、附录B为资料性附录。本标准由全国信息分类与编码标准化技术委员会提出并归口;本标准的起草单位:全国组织机构代码管理中心。本标准的主要起草人:。目 次前言15
13、引言III1范围42规范性引用文件43术语和定义44服务接口5附录A10GB/TXXXXX-2015用于微博客的组织机构代码实名认证服务接口规范引 言本标准详细描述了组织机构代码管理中心向微博客商业网站提供组织机构微博客实名信息对比的 要求,主要包括接口调用、数据定义、数据加密等要求。组织机构代码作为组织机构的“身份证”,通 过使用组织机构代码库信息用于微博客实名认证,无论对微博客网站、组织机构来说都有重要的意义, 是深化微博客实名制应用,以促进微博健康发展的关键。用于微博客的组织机构代码实名认证服务接口规范1范围本标准规定了用于微博客组织机构代码服务接口的格式规范,详细定义了微博客商业网站
14、访问组织机构代码信息资源的接口要求,包括:接口调用、数据加密要求、格式要求、数据类 型定义等。本标准适用于所有访问组织机构代码信息的微博客商业网站在接受组织机构微博帐户注册 时,进行信息对比认证的过程。本标准所使用的术语定义及数据元素仅限于本标准。2规范性引用文件下列文件中的条款通过本标准的应用而成为本标准的的条款。凡是注日期的引用文件,仅 所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单) 适用于本文件。GB/T 11714-1997全国组织机构代码编制规则GB/T 18793-2002信息技术 可扩展置标语言(XML) 1.0GB/T 7408-2005数据
15、元和交换格式 信息交换 日期和时间表示法3术语和定义3. 1微博客MicroBlog一种通过关注机制分享咨询的广播式的社交网络平台。4. 2微博客网站 M i cro BI og Webs i te承载微博客系统的门户网站。5. 3组织机构Organ i zat i on指中华人民共和国内依法注册、依法登记的机关、企、事业单位、社会团体,以及其他类 型组织。6. 4组织机构代码 Organ i zat i on code对中华人民共和国内依法注册、依法登记的机关、企、事业单位、社会团体,以及其他组 织机构颁发一个在全国范围内唯一的、始终不变的代码标识。按照强制性国家标准GB11714全 国组织
16、机构代码编制规则编制,由八位数字(或大写拉丁字母)本体代码和一位数字(或大写拉 丁字母)校验码组成。7. 5组织机构代码库 Orgnization Code Database全国组织机构代码中心及其分中心对于组织机构管理过程所产生的数据。8. 6月员务才妾口 Service iinterface计算机软件系统之间进行共享数据、交换信息的支持程序,以电子文件的形式实现。9. 7WSDL Web Services Descr ipt ion LanguageWSDL是一种XML应用,它将Web服务描述定义为一组服务访问点,使用者可以通过这些服务 访问点对包含面向文档信息或面向过程调用的服务进行访问
17、。4服务接口4.1实名备案接口a)接口定义实名备案:public String recordDMInfo(String operatorCode, String opinfo);调用时需完全吻合方法名称的大小写、请求参数个数、请求参数的位置和请求参数类型。b)接口参数说明表1接口参数序号参数名数据类型描述1operatorCodeString微博客运营商实名备案申请表中组织机 构代码证号,省略连字符(-)o2opinfoString规定格式的XML标准字符串。c) XML格式规范说明表2实名备案请求opinfo网站名称/ WZMC 网站域名 申请单位名称/ZZ JGMC法定代表人姓名ZJHM
18、法人证件 SQR申请人姓名/SQRSQR_Z川M申请人证件号码MEMO备用字段/MEMO表3 实名备案返回recordDMInfo?xml version=1.0 encoding=UTF-8 ?BAZT备案状态/ BAZT备案状态说明/ ZTSM 备案号/ BAII 网站域名 备用字段 4.2实名认证接口a)接口定义实名认证:public String verifyDMInfo(String companyCode, String dmlnfo);调用时需完全吻合方法名称的大小写、请求参数个数、请求参数的位置和请求参数类型。b)接口参数说明表4接口参数序号参数名数据类型描述1companyC
19、odeString微博客网站接收组织机构类用户申请微 博客账号的申请表中填写的9位组织机 构代码,省略连字符(-)o2dmlnfoString规定格式的XML标准字符串。c) XML格式规范说明表5 实名认证请求dmlnfoWBWZBM组织机构微博帐户ZZJGDMMf,织机构代码/ZZJGDM组织机构名称/ZZJGMO法定代表人姓名Z川心法人证件SQR申请人姓名申请人证件号码MEMO备用字段/MEMO表6 实名认证返回verifyDMInfo请求返回状态码/ FIIBM状态码说明信息/ JGSM 比对回执码/ BDHZM 备用字段 4.3冒用申诉接口a)接口定义冒用 申诉:public Str
20、ing appealDMInfo(String appealCode, String aplnfo);调用时需完全吻合方法名称的大小写、请求参数个数、请求参数的位置和请求参数类型。b)接口参数说明表7接口参数序号参数名数据类型描述1appealCodeString微博客网站接收组织机构类用户申诉微 博客账号被冒用的申请表中填写的9位 组织机构代码,省略连字符(-)o2aplnfoString规定格式的XML标准字符串。c) XML格式规范说明表8冒用申诉请求aplnfoWBWZBM组织机构微博帐户组织机构代码ZZJGMO组织机构名称/ZZJGMO法定代表人姓名法人证件申请人姓名/SQR申请人证
21、件号码 备用字段 表9冒用申诉返回appealDMInfo请求返回状态码/ FHBM状态码说明信息比对回执码/ BDHZM 备用字段 4.4数据定义a)请求信息请求信息数据类型定义见下表。表10请求信息表节点名称中文名称含义说明数据类型值域WZMC网站名称微博客运营商的网 站名称字符串必填项,长度限制在130字 符内,加密WZYM网站域名微博客运营商的网 站域名字符串必填项,长度限制在130字 符内,加密WBWZBH组织机构微博帐户组织机构在商业网 站申请的微博帐 户。字符串必填项,长度限制在50字符 内,加密JGDM组织机构代码申请微博帐户关联 的组织机构代码。字符串必填项,长度为9字符,符
22、 合 GB/T 11714-1997,加密JGMC组织机构名称申请微博帐户关联 的组织机构名称。字符串必填项,长度限制在130字 符内,加密FDDBR法定代表人姓名申请微博帐户关联 的组织机构法人姓 名字符串必填项,长度限制在130字 符内,加密ZJHM法人证件申请微博帐户关联 的法人证件号码字符串必填项,长度限制在50字符 内,加密SQR申请人姓名组织机构微博帐户 申请人姓名字符串必填项,长度限制在130字 符内,加密SQR_ZJHM申请人证件号码组织机构微博帐户 申请人有效身份证 件号码字符串必填项,长度限制在50字符 内,加密MEMO备用字段扩展位,备用字符串非必填,为空时项节点保留, 长度限制在120字符内,非 空时加密b)比对结果指全国组织机构代码中心数据服务利用微博客网站传递的对比信息与组织机构代码库信息进行对比,返回比对结果,数据类型定义见表5。表11比对结果英文名称中文名称含义数据类型值域BAZT备案状态微博客运营商申请备 案的状态字符串必填项,长度限制在10 字符内,加密ZTSM备案状态说明备案状态的原因说明字符串必填项,长度限制在150 字符内,加密