资料库 API列表
联系我们
注册 登录

ca1,版权数据检索接口

  • 请求地址:

    地址:https://open.cnipr.com/cnipr-api/v1/api/cocave/ca1/{client_id}

  • 请求方法:

    HTTP POST

  • 请求参数:

    取 消 提交申请 清空
    参数名称 参数说明 是否必填 参数类型
    client_id 应用id,如没有clientId请先接入应用,查看接入流程获取 true String
    openid 用户id,可通过 Implicit Grant 方式 Authorization Code 方式 等两种方式获取openid true String
    access_token 访问令牌,可通过 Implicit Grant 方式 Authorization Code 方式Refresh Token 方式 等三种方式获取access_token获取token true String
    exp 检索表达式,例:作品名称=奔腾电磁炉
    表达式能够拼写字段见 CopyrightDto说明字段
    true String
    orders 排序字段,字段前加+号表示升序,加-号表示降序。多个字段排序以逗号分隔,优先级按字段先后顺序。
    使用示例:+firstPublishDate表示首次发表日期升序,-firstPublishDate表示首次发表日期降序;
    false List<String>
    from 返回值起始坐标,默认为0,不能为负数。from:0表示从第1条开始取数据 true int
    size 检索结果集数,上限为100,默认为10 true String
    queryType 检索类型,默认值:2 (按字检索)其它值含义见附录 false int
    returnValues 检索返回字段,多个字段以逗号分隔。未填写则返回默认字段。字段描述见 CopyrightDto属性名称字段 true String[]
  • Postman 调用展示 ca1.jpg
  • 部分请求参数如下(returnValues为全部可用检索字段):
    exp:作品名称=奔腾电磁炉
    orders:+firstPublishDate
    queryType:2
    from:0
    size:10
    returnValues:abbrName,author,changeOrSupplementNotice,changeOrSupplementNum,city,classifyNum,copyrightOwner,copyrightType,country,
    finishDate,firstPublishDate,fullName,opusName,opusType,province,publishDate,registerDate,registerNum,versionNum,withdrawNotice
                                                
  • Java + HTTP POST
    public class SearchClientTest {
    	String client_id = "CLIENT_ID";
    	String openid = "OPENID";
    	String access_token = "ACCESS_TOKEN";
    
    	/**
    	 * 版权数据检索接口
    	 */
    	@Test
    	public void expSerachTest() throws Exception {
    		String url = "/v1/api/cocave/ca1/"+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", "作品名称=奔腾电磁炉"));
    		nvps.add(new BasicNameValuePair("orders", "+firstPublishDate"));
    		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", "abbrName,author,changeOrSupplementNotice,changeOrSupplementNum,city,classifyNum,copyrightOwner,copyrightType,country,
    finishDate,firstPublishDate,fullName,opusName,opusType,province,publishDate,registerDate,registerNum,versionNum,withdrawNotice"));
    		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<CopyrightDto> -- 数据详细
  • results数据详细说明:

    CopyrightDto

    属性名称 说明 类型
    abbrName软件简称 (软著字段)string
    addressstr地址string
    author作者(作著字段)string
    changeOrSupplementNotice变更或补充公告(软著字段)List<ComputerChangeSupplementaryRegistrationDto> -- 变更或补充公告
    changeOrSupplementNum变更或补充公告编号(软著字段)array
    city原城市string
    citystr城市string
    classifyNum分类号(软著字段)string
    copyrightOwner著作权人string
    copyrightType版权类别string
    country国籍string
    customs海关备案List<CustomsInfoDto> -- 海关备案
    eastareastring
    finishDate创作完成日期(作著字段)string
    firstPublishDate首次发表日期(作著字段)string
    fullName软件全称(软著字段)string
    opusName作品名称(作著字段)string
    opusType作品类别(作著字段)string
    orgstr组织string
    permission专用许可合同登记公告(软著字段)List<ComputerPermissionDto> -- 专用许可合同登记公告
    province原省份string
    provincestr省份string
    publishDate发布日期string
    registerDate登记日期(软著字段)string
    registerNum登记号string
    transfer转让登记公告(软著字段)List<ComputerTransferDto> -- 转让登记公告
    versionNum版本号string
    withdrawNotice撤销公告(软著字段)List<ComputerRevocationNoticeDto> -- 撤销公告
    zone园区string
    rightScope权利范围string
    rightAcquisitionMethod权利获得方式string

    ComputerChangeSupplementaryRegistrationDto -- 变更或补充公告

    属性名称 说明 类型
    changeAfter 变更后 string
    changeBefore 变更前 string
    changeOrSupplementItem 变更或补充事项 string
    number 编号 string
    originalSoftwareName 原软件名称 string
    registerDate 登记日期 string
    registerNum 登记号 string
    supplementAfter 补充后 string
    supplementBefore 补充前 string

    CustomsInfoDto -- 海关备案

    属性名称 说明 类型
    enddate结束日期string
    recordno备案号string
    startdate生效日期string
    state状态string
    viewstate审批意见string

    ComputerPermissionDto -- 专用许可合同登记公告

    属性名称 说明 类型
    assignee受让方string
    lrregisterNum登记号string
    registerDate登记日期string
    softwareName软件名称string
    swregisterNum软件著作权登记号string
    transferor转让方string

    ComputerTransferDto -- 转让登记公告

    属性名称 说明 类型
    arregisterNum登记号string
    assignee受让方string
    registerDate登记日期string
    softwareName软件名称string
    swregisterNum软件著作权登记号string
    transferor转让方string

    ComputerRevocationNoticeDto -- 撤销公告

    属性名称 说明 类型
    originalRegistrant 原登记者 string
    registerNum 登记号 string
    softwareName 软件名称 string
    withdrawDate 撤销日期 string
    withdrawReason 撤销原因 string