[C011]知识产权可以返回哪些数据？

[C011]知识产权：该接口提供企业专利，商标，软著，集成电路布图设计等的数量统计。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [C011]知识产权的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1company~1intellectual-property/post，也可在 /openapi.json 浏览完整规范。

[C011]知识产权

Q: [C011]知识产权 的接口地址是什么？

[C011]知识产权 的接口为 POST https://connect.zhihuiya.com/company/intellectual-property。

post

https://connect.zhihuiya.com/company/intellectual-property

在体验中心中试用

该接口提供企业专利，商标，软著，集成电路布图设计等的数量统计

company_name、credit_code、org_number三者必填其一，同时填写则以credit_code 为准，其次org_number，最后以company_name为准。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`company_name`	`string`	`小米科技有限责任公司`	查询企业名称，单个查询
`credit_code`	`string`	`91110108551385082Q`	查询企业的统一社会信用代码，单个查询
`org_number`	`string`	`5513850T82`	查询企业的组织机构代码，单个查询

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`other_ip`	`object`	`otherIp`	其他信息
`ic_cnt`	`integer<int32>`	-	集成电路布图设计总量
`ic_cnt_fy1`	`integer<int32>`	-	FY1集成电路布图设计数量 (FY1：当前时间的年份所在的自然年，即今年)
`ic_cnt_fy2`	`integer<int32>`	-	FY2集成电路布图设计数量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`ic_cnt_fy3`	`integer<int32>`	-	FY3集成电路布图设计数量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`copy_reg_cnt`	`integer<int32>`	`37`	软著总量
`trademark_cnt`	`integer<int32>`	`46`	商标总量
`copy_reg_cnt_fy1`	`integer<int32>`	-	FY1软著数量 (FT1：当前时间的年份所在的自然年，即今年)
`copy_reg_cnt_fy2`	`integer<int32>`	-	FY2软著数量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`copy_reg_cnt_fy3`	`integer<int32>`	`2`	FY3软著数量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`trademark_cnt_fy1`	`integer<int32>`	-	FY1商标数量 (FY1：当前时间的年份所在的自然年，即今年)
`trademark_cnt_fy2`	`integer<int32>`	-	FY2商标数量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`trademark_cnt_fy3`	`integer<int32>`	-	FY3商标数量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`new_plant_variety_cnt`	`integer<int32>`	`12`	植物新品种总量
`new_plant_variety_cnt_fy1`	`integer<int32>`	-	FY1植物新品种数量 (FY1：当前时间的年份所在的自然年，即今年)
`new_plant_variety_cnt_fy2`	`integer<int32>`	-	FY2植物新品种数量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`new_plant_variety_cnt_fy3`	`integer<int32>`	-	FY3植物新品种数量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`org_number`	`string`	`05669441-9`	组织机构代码
`credit_code`	`string`	`913205940566944300`	社会统一信用代码
`company_name`	`string`	`苏州瀚川智能科技股份有限公司`	企业名称
`patent_current`	`object`	`PatentApplication`	专利当前信息
`pct_apno_current_cnt`	`integer<int32>`	-	PCT专利数量
`sep_apno_current_cnt`	`integer<int32>`	-	标准必要专利数量
`valid_apno_current_cnt`	`integer<int32>`	`424`	有效专利数量
`design_apno_current_cnt`	`integer<int32>`	`27`	外观专利数量
`utility_apno_current_cnt`	`integer<int32>`	`383`	实用新型专利数量
`invention_apno_current_cnt`	`integer<int32>`	`148`	发明专利数量
`valid_design_apno_current_cnt`	`integer<int32>`	`25`	有效外观专利数量
`valid_utility_apno_current_cnt`	`integer<int32>`	`366`	有效实用新型专利数量
`valid_invention_apno_current_cnt`	`integer<int32>`	`33`	有效发明专利数量
`defense_decryption_apno_current_cnt`	`integer<int32>`	-	国防解密专利数量
`patent_application`	`object`	`Please check the form: PatentApplication`	专利应用信息
`cn_apno_cnt`	`integer<int32>`	`530`	国内专利申请总量
`pct_apno_cnt`	`integer<int32>`	`5`	PCT专利申请总量
`design_apno_cnt`	`integer<int32>`	`27`	外观专利申请总量
`non_cn_apno_cnt`	`integer<int32>`	`10`	国外专利申请总量
`utility_apno_cnt`	`integer<int32>`	`370`	实用新型专利申请总量
`invention_apno_cnt`	`integer<int32>`	`143`	发明专利申请总量
`design_apno_cnt_fy1`	`integer<int32>`	-	FY1外观专利申请量 (FY1：当前时间的年份所在的自然年，即今年)
`design_apno_cnt_fy2`	`integer<int32>`	`10`	FY2外观专利申请量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`design_apno_cnt_fy3`	`integer<int32>`	`7`	FY3外观专利申请量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`utility_apno_cnt_fy1`	`integer<int32>`	`3`	FY1实用新型专利申请量 (FY1：当前时间的年份所在的自然年，即今年)
`utility_apno_cnt_fy2`	`integer<int32>`	`75`	FY2实用新型专利申请量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`utility_apno_cnt_fy3`	`integer<int32>`	`99`	FY3实用新型专利申请量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`invention_apno_cnt_fy1`	`integer<int32>`	`7`	FY1发明专利申请量 (FY1：当前时间的年份所在的自然年，即今年)
`invention_apno_cnt_fy2`	`integer<int32>`	`43`	FY2发明专利申请量 (FY2：当前时间的年份-1 所在的自然年，即去年)
`invention_apno_cnt_fy3`	`integer<int32>`	`44`	FY3发明专利申请量 (FY3：当前时间的年份-2 所在的自然年，即前年)
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "other_ip": {
      "ic_cnt": 0,
      "ic_cnt_fy1": 0,
      "ic_cnt_fy2": 0,
      "ic_cnt_fy3": 0,
      "copy_reg_cnt": 37,
      "trademark_cnt": 46,
      "copy_reg_cnt_fy1": 0,
      "copy_reg_cnt_fy2": 0,
      "copy_reg_cnt_fy3": 2,
      "trademark_cnt_fy1": 0,
      "trademark_cnt_fy2": 0,
      "trademark_cnt_fy3": 0,
      "new_plant_variety_cnt": 12,
      "new_plant_variety_cnt_fy1": 0,
      "new_plant_variety_cnt_fy2": 0,
      "new_plant_variety_cnt_fy3": 0
    },
    "org_number": "05669441-9",
    "credit_code": 913205940566944300,
    "company_name": "苏州瀚川智能科技股份有限公司",
    "patent_current": {
      "pct_apno_current_cnt": 0,
      "sep_apno_current_cnt": 0,
      "valid_apno_current_cnt": 424,
      "design_apno_current_cnt": 27,
      "utility_apno_current_cnt": 383,
      "invention_apno_current_cnt": 148,
      "valid_design_apno_current_cnt": 25,
      "valid_utility_apno_current_cnt": 366,
      "valid_invention_apno_current_cnt": 33,
      "defense_decryption_apno_current_cnt": 0
    },
    "patent_application": {
      "cn_apno_cnt": 530,
      "pct_apno_cnt": 5,
      "design_apno_cnt": 27,
      "non_cn_apno_cnt": 10,
      "utility_apno_cnt": 370,
      "invention_apno_cnt": 143,
      "design_apno_cnt_fy1": 0,
      "design_apno_cnt_fy2": 10,
      "design_apno_cnt_fy3": 7,
      "utility_apno_cnt_fy1": 3,
      "utility_apno_cnt_fy2": 75,
      "utility_apno_cnt_fy3": 99,
      "invention_apno_cnt_fy1": 7,
      "invention_apno_cnt_fy2": 43,
      "invention_apno_cnt_fy3": 44
    }
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码	描述
`68300004`	请求参数异常!
`68300005`	查询Api失败!
`68300006`	解析基本存取错误!
`68300007`	存在错误的请求!
`68300008`	服务中断异常，请稍后再试!
`68300010`	文件不符合上传规范!

平台错误码

错误码	描述
`67200001`	API整体限流错误!
`67200002`	用户调用请求限流限制错误!
`67200003`	申请token的key和secret不正确或者状态错误!
`67200004`	无权限或该接口的套餐已超过系统设置的上限!
`67200005`	账户余额不足，调用失败!
`67200006`	客户端已过期，调用失败!
`67200007`	超过调用额度，调用失败!

HTTP 状态码

状态码	描述
`0`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found
`68300012`	企业数据不存在