[A008]简单法律状态统计

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

通过专利有效/失效/审查中等状态的占比分析，帮助衡量该技术领域的专利活跃程度。

应提供关键词、IPC、检索式中的至少一个。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
apply_end_time
string2020
专利申请截止时间，格式:yyyy
apply_start_time
string2010
专利申请起始时间，格式:yyyy
authority
stringCN
选择专利的受理局，如CN、US、EP、JP等，具体可以参考https://analytics.zhihuiya.com/status。 默认查询全部数据。 搜索专利受理局代码，多个代码可以用逻辑符OR连接 例如输入：US OR EP
ipc
stringB66B11
专利的IPC分类号
keywords
stringcar
关键词在专利的标题和摘要中精确搜索。支持AND、OR、NOT连接关键词，如 "手机 AND (屏幕 OR 电池)"。
public_end_time
string2020
专利公开截止时间，格式:yyyy
public_start_time
string2010
专利公开起始时间，格式:yyyy
query_text
stringTACD: virtual reality
输入Analytics检索式，最大长度为800字符，且不可包含 $W $PRE $WS $SEN $PARA $FREQ 等复杂通配符。

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
array-
响应数据
pn
stringUS11205304B2
公开(公告)号
patent_id
string718ead9c-4f3c-4674-8f5a-24e126827269
专利Id
simple_legal_status
array[ "Pending" ]
简单法律状态

如：有效-Active，审中-Pending，失效-Inactive，未确认-Undetermined，PCT指定期内-PCT designated period，PCT指定期满-PCT designated expiration

status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": [
    {
      "pn": "US11205304B2",
      "patent_id": "718ead9c-4f3c-4674-8f5a-24e126827269",
      "simple_legal_status": [
        "Pending"
      ]
    }
  ],
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
401Unauthorized
403Forbidden
404Not Found