社文商标大数据接口协议文档

1、社文商标大数据接口协议文档接口规范版本（ 1.2 ）目录目录.21.文档介绍 .51.1.文档说明 .51.2.读者对象 .51.3.版权声明 .51.4.业务术语 .51.5.代码示例说明 .62.作业流程简述 .82.1.服务定制流程 .82.2.接口账户测试 .82.3.接口调用流程 .92.4.作业流程说明 .93.中国商标注册号精确查询接口 .93.1.接入 URL .93.2.接入方式 .103.3.协议请求参数 .103.4.签名规则说明 .103.5.接口响应 .103.6.请求示例 .114.中国商标名称精确查询接口 .134.1.接入 URL .134.2.接入方式 .13

2、4.3.协议请求参数 .134.4.签名规则说明 .144.5.接口响应 .144.6.请求示例 .155.中国商标申请人精确查询接口 .175.1.接入 URL .175.2.接入方式 .175.3.协议请求参数 .175.4.签名规则说明 .175.5.接口响应 .185.6.请求示例 .196.中国商标快捷检索接口 .206.1.接入 URL .206.2.接入方式 .216.3.协议请求参数 .216.4.签名规则说明 .216.5.接口响应 .226.6.请求示例 .247.中国商标名称近似查询接口 .267.1.接入 URL .267.2.接入方式 .267.3.协议请求参数 .2

3、67.4.签名规则说明 .267.5.接口响应 .277.6.请求示例 .288.中国商标图形商标近似查询接口.298.1.接入 URL .308.2.接入方式 .308.3.协议请求参数 .308.4.签名规则说明 .308.5.接口响应 .318.6.请求示例 .319.中国商标详情查询接口 .339.1.接入 URL .339.2.接入方式 .339.3.协议请求参数 .339.4.签名规则说明 .349.5.接口响应 .349.6.商标详情说明 .369.7.请求示例 .3810.中国商标图形要素查询接口 .4010.1.接入 URL .4010.2.接入方式 .4010.3.协议请求

4、参数 .4010.4.签名规则说明 .4110.5.接口响应 .4110.6.请求示例 .4211.中国商标高级查询接口 .4411.1.接入 URL .4411.2.接入方式 .4411.3.协议请求参数 .4411.4.签名规则说明 .4411.5.接口响应 .4511.6.请求示例 .4612.中国商标名称监测接口 .4812.1.接入 URL .4812.2.接入方式 .4812.3.协议请求参数 .4812.4.签名规则说明 .4812.5.接口响应 .4912.6.请求示例 .5013.中国商标图形商标监测接口 .5113.1.接入 URL .5213.2.接入方式 .5213.3

5、.协议请求参数 .5213.4.签名规则说明 .5213.5.接口响应 .5313.6.请求示例 .5314.图片上传接口 .5514.1.接入 URL .5514.2.接入方式 .5514.3.协议请求参数 .5514.4.签名规则说明 .5614.5.接口响应 .5614.6.请求示例 .5715.香港商标综合查询接口 .6115.1.接入 URL .6115.2.接入方式 .6115.3.协议请求参数 .6115.4.签名规则说明 .6215.5.接口响应 .6215.6.请求示例 .6316.香港商标近似查询接口 .6516.1.接入 URL .6516.2.接入方式 .6516.3.

6、协议请求参数 .6516.4.签名规则说明 .6516.5.接口响应 .6616.6.请求示例 .6617.香港商标详情查询接口 .6717.1.接入 URL .6717.2.接入方式 .6817.3.协议请求参数 .6817.4.签名规则说明 .6817.5.接口响应 .6917.6.请求示例 .7017.7.商标详情说明 .71附录一 响应状态码说明一览 .72附录二 协议接口参数一览 .721. 文档介绍1.1. 文档说明本协议文档用来实现社文商标查询接口的顺利对接。请相关技术开发人员详细阅读本文档。社文商标数据查询接口的功能： 开通查询接口账户， 定制服务后可参考本文档调用所定制的接口

7、查询需要的商标信息。文中 黑粗的内容表示要重点注意的内容。1.2. 读者对象接口文档面向具有一定网站开发能力，了解ASP、PHP、JSP、ASP.NET等开发语言中的网站开发、测试、维护和管理人员。1.3. 版权声明此文档版权归社文科技有限公司所有。 作为本系统的最终用户， 可以拥有该份文档的使用权，但未征得社文科技有限公司的书面批准，不得向第三方借阅、出让、出版该文档。1.4. 业务术语商标监测1、对于已经注册公告的商标，以自己注册的商标为保护对象，对国家商标局发布的初审商标公告中的类似或雷同的商标进行监测。2、对某些商标的法律状态进行监测。近似查询要查询的商标与已经注册公告的商标是否相同或

8、相似，以确定是否对己商标注册。商标图样商标图样指商标注册申请时提供给国家商标局的商标图片文件，支持 .png,.jpg,jpeg格式，一般情况下只要一张图片高级查询根据商标名称和商品与服务小类名称查询商标的过程称为高级查询。1.5. 代码示例说明以下所列接口代码示例有php 和 Java，其他语言暂不列举。其中 PHP代码经过调整可直接运行得到响应数据。Java代码给出核心示例，在此给出一个完整的代码示例，如下所示：public class HttpRequestWebprivate static String MD5(String s) try MessageDigest md = Mess

9、ageDigest.getInstance("MD5");byte bytes = md.digest(s.getBytes("utf-8");return toHex(bytes);catch (Exception e) throw new RuntimeException(e);private static String toHex(byte bytes) final char HEX_DIGITS = "0123456789ABCDEF".toCharArray(); StringBuilder ret = new String

10、Builder(bytes.length * 2);for (int i=0; i<bytes.length; i+) ret.append(HEX_DIGITS(bytesi >> 4) & 0x0f);ret.append(HEX_DIGITSbytesi & 0x0f);return ret.toString();public static void main(String args)String method="post",url="",params="",result = "&qu

11、ot;,line;PrintWriter out = null;BufferedReader in = null;try/params = String.format("tm_name=%s",URLEncoder.encode(" 社标网 ","UTF-8"); params += String.format("&page_no=%d&page_size=%d",1,10);params += String.format("&user_ip=%s","127_

12、127_12_12"); params+=String.format("&key=%s&pwd=%s&user_name=%s","test014n98vmay","4n98vmay","test01");String sign=MD5(params);params += String.format("&sign=%s",sign);if( "get"=method )url += "?"+params;URL r

13、ealUrl = new URL(url);URLConnection conn = realUrl.openConnection();if( "post"=method )conn.setDoOutput(true);conn.setDoInput(true);out = new PrintWriter(conn.getOutputStream();out.print(params);out.flush();in = new BufferedReader( new InputStreamReader( conn.getInputStream() ) ); while (l

14、ine = in.readLine() != null) result += line;/print result of responsingcatch (Exception e) e.printStackTrace();下图所示为核心代码片段，用下面各章节（第段替换下图所示代码即可实现接口的java 调用312章）示例中的java代码的蓝色字体片2. 作业流程简述2.1. 服务定制流程业务服务定制流程图如下所示（2-1-1 ）：图 2-1-12.2. 接口账户测试查询接口账户开通后可以在浏览器地址栏中输入以下内容测试帐户的可用性。如果页面显示如下图所示（2-2-1）提示信息，说明账户有效，开通成功 ；否则， 显示相应的错误信息 。“x”表示申请账户时社文发送给客户的邮件中的具体账户信息图 2-2-12.3. 接口调用流程接口调用时序图如下图（2-3-1）所