[A109]企业简单法律状态统计

get
https://connect.zhihuiya.com/insights-company/simple-legal-status
在体验中心中试用

该分析通过专利有效/失效/审查中等状态的占比分析，帮助衡量该公司的专利活跃程度。通常情况下，审中状态的专利占比越大，反映该企业近期创新活力越高。其中，未确认状态为无数据的情况。

国内企业：请填写company_name、credit_code或org_number，三者必填其一，同时填写则以 credit_code 为准，其次org_number，最后以company_name为准。

国外企业：请填写完整的company_name以获得企业分析报告信息。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
company_name
string华为技术有限公司
查询企业名称，单个查询
org_number
string192203821
查询企业的组织机构代码，单个查询
credit_code
string914403001922038216
查询企业的统一社会信用代码，单个查询
apply_start_time
string2010
专利申请起始时间，格式:yyyy
apply_end_time
string2020
专利申请截止时间，格式:yyyy
public_start_time
string2010
专利公开起始时间，格式:yyyy
public_end_time
string2020
专利公开截止时间，格式:yyyy
simple_legal_status
string1 OR 2
专利的简单法律状态:

0-失效

1-有效

2-审中

220-PCT指定期满

221-PCT指定期内

999-未确认

可以多选，多个内容项之间用OR拼接（参数和OR之间有空格）

patent_type
stringA OR B
专利的申请类型

A: 发明申请

B: 授权发明

U: 实用新型

D: 外观设计

可以多选，多个内容项之间用OR拼接（参数和OR之间有空格）

authority
stringCN OR EP
选择专利的受理局，如CN、US、EP、JP等，具体可以参考https://analytics.zhihuiya.com/status。 默认查询全部数据。

搜索专利受理局代码，多个代码可以用逻辑符OR连接

例如输入：US OR EP

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
array-
响应数据
count
integer<int32>20
专利数量
percentage
number<double>0.1777
占比
simple_legal_status
string1
简单法律状态。 0-失效 1-有效 2-审中 999-未确认 220-PCT指定期满 221-PCT指定期内
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": [
    {
      "count": 20,
      "percentage": 0.1777,
      "simple_legal_status": 1
    }
  ],
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

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

HTTP 状态码

状态码描述
0请求成功