ve1，裁判文书检索接口
- 请求地址：
地址：https://open.cnipr.com/cnipr-api/v1/api/cocave/ve1/{client_id}
- 请求方法：
HTTP POST
- 请求参数：
参数名称 参数说明 是否必填 参数类型 client_id 应用id，如没有clientId请先接入应用，查看接入流程获取 true String openid 用户id，可通过 Password Grant 方式 或 Implicit Grant 方式 或 Authorization Code 方式 获取 true String access_token 访问令牌，可通过 Password Grant 方式 或 Implicit Grant 方式 或 Authorization Code 方式或 Refresh Token 方式
快速获取access_token true String exp 检索表达式，例：作品名称=奔腾电磁炉
表达式能够拼写字段见 VerdictDto说明字段true String orders 排序字段，字段前加+号表示升序，加-号表示降序。多个字段排序以逗号分隔，优先级按字段先后顺序。 使用示例：+legalYear表示案件发文年份升序，-legalYear表示案件发文年份降序； false List<String> from 返回值起始坐标，默认为0，不能为负数。from:0表示从第1条开始取数据 true int size 检索结果集数，上限为100，默认为10 true String queryType 检索类型：2 (按字检索，默认值); 1 (按词检索); 3 (同义词检索) false int returnValues 检索返回字段，多个字段以逗号分隔。未填写则返回默认字段。字段描述见 VerdictDto属性名称字段 true String[]
-
Postman 调用展示
- 部分请求参数如下（returnValues为全部可用检索字段）：
exp:作品名称=奔腾电磁炉 orders:+firstPublishDate queryType:2 from:0 size:10 returnValues:acceptDate,allText,appellee,appellent,applyCost,caseName,clerk,courtCity,courtLevel,courtName,courtNum,courtProvince, defendentAgentNames,defendentAgentOrgs,defendentPres,evidences,hearProcess,involvedAppNo,involvedPubNo,ipTypes,judge,judgeCost,jury, lawReferences,legalId,legalNum,legalNumberSuperiors,legalYear,originPass,pkdocAppNum,plaintiffAgentNames,plaintiffAgentOrgs,plaintiffPres, preJudge,proxyJudge,proxyPreJudge,standardPkdoc,thirdPerson,thirdPersonAgentNames,thirdPersonAgentOrgs,thirdPersonPres,title,trademarkNum, verdictDate,verdictInfor,verdictName,verdictProperty,verdictResultType,verdictType,verdictYear
- Java + HTTP POST
public class SearchClientTest { String client_id = "CLIENT_ID"; String access_token = "ACCESS_TOKEN"; String openid = "OPENID"; /** * 裁判文书检索接口 */ @Test public void expSerachTest() throws Exception { String url = "/v1/api/cocave/ve1/"+client_id; List<NameValuePair> nvps = new ArrayList<NameValuePair>(); // 提交参数及值 nvps.add(new BasicNameValuePair("openid", openid)); nvps.add(new BasicNameValuePair("access_token", access_token)); nvps.add(new BasicNameValuePair("exp", "案件发文号=（2012）民申字第1391号")); nvps.add(new BasicNameValuePair("orders", "+legalYear")); nvps.add(new BasicNameValuePair("from", "0")); //from:0，表示从第1条开始取，不能为负数 nvps.add(new BasicNameValuePair("size", "10")); //size:10，表示取10条，上限为50条，不能为负数 nvps.add(new BasicNameValuePair("queryType", "2")); nvps.add(new BasicNameValuePair("returnValues", "acceptDate,appellee,appellent,applyCost,caseName,clerk,courtCity, courtLevel,courtName,courtNum,courtProvince")); this.POST(url, nvps); this.POST(url, nvps); } public void POST(String url, List<NameValuePair> nvps) throws Exception { DefaultHttpClient httpclient = new DefaultHttpClient(); HttpPost httppost = new HttpPost(url); httppost.setHeader("ContentType", "application/x-www-form-urlencoded"); // 设置表单提交编码为UTF-8 UrlEncodedFormEntity entry = new UrlEncodedFormEntity(nvps, "UTF-8"); entry.setContentType("application/x-www-form-urlencoded;charset=UTF-8"); httppost.setEntity(entry); HttpResponse response = httpclient.execute(httppost); HttpEntity entity = response.getEntity(); String ss = EntityUtils.toString(entity, "UTF-8"); //打印返回结果 System.out.println(ss); EntityUtils.consume(entity); httpclient.getConnectionManager().shutdown(); } }
- 响应参数：
属性名称 属性说明 属性类型 status 状态码，0代表成功，其它值含义见附录 long message 响应的信息描述 String total 命中总数 long from 检索起始位 int size 检索数量 int results 检索结果集 List<VerdictDto> -- 数据详细
- results数据详细说明：
VerdictDto
属性名称 说明 类型 acceptDate 受理日期 string allText 全文 string appellee 被告或被上诉人 List<String> appellent 原告或上诉人 List<String> applyCost 申诉金额 string caseName 案件名称 string clerk 书记员 List<String> courtCity 法院辖区 string courtLevel 法院级别 string courtName 法院名称 string courtNum 中级法院编号 string courtProvince 法院所属省 string defendentAgentNames 被告或被上诉人委托代理人姓名 List<String> defendentAgentOrgs 被告或被上诉人委托代理机构 List<String> defendentPres 被告或被上诉人代表人 List<String> evidences 证据 List<String> hearProcess 审理程序 string involvedAppNo 涉案申请号 string[][] involvedPubNo 涉案公开（公告）号 string[][] ipTypes 知识产权分类 List<String> judge 审判员 List<String> judgeCost 审判金额 string jury 人民陪审员 List<String> lawReferences 法律法规 List<String> legalId 案件发文号 string legalNum 案件发文数字号 string legalNumberSuperiors 上级案例编号 List<String> legalYear 案件发文年份 string originPass 案由 string pkdocAppNum 主专利申请号 string plaintiffAgentNames 原告或上诉人委托代理人姓名 List<String> plaintiffAgentOrgs 原告或上诉人委托代理机构 List<String> plaintiffPres 原告或上诉人代表人 List<String> preJudge 审判长 List<String> proxyJudge 代理审判员 List<String> proxyPreJudge 代理审判长 List<String> standardPkdoc 标准化主专利号 string thirdPerson 第三人 List<String> thirdPersonAgentNames 第三人委托代理人姓名 List<String> thirdPersonAgentOrgs 第三人委托代理人机构 List<String> thirdPersonPres 第三人代表人 List<String> title 原文标题 string trademarkNum 商标号 List<String> verdictDate 文书落款日期 string verdictInfor 案件胜负信息 string verdictName 文书名称 string verdictProperty 文书性质 string verdictResultType 判决结果类型 string verdictType 文书类型 string verdictYear 文书落款日期年份 string