[P013]法律状态

get
https://connect.zhihuiya.com/basic-patent-data/legal-status
在体验中心中试用

可以通过输入patent_id或patent_number查询具体某条专利的法律状态信息。包含简单法律状态、法律状态、法律事件。详细内容可以查看开发者文档中返回字段说明。

专利id和公开号两个参数必须要有一个，如果两个都存在，会优先使用专利id。 该接口支持批量请求，上限为100条，请求参数相互之间用英文,隔开。批量请求在进行流量/费用扣减的时候，会根据返回结果的成功条数进行多次扣减。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
patent_id
stringb54b4e0c-c0f5-4cf6-9ede-36394a7e2f0b
专利id
patent_number
stringUS20220119699A9
公开公告号

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
array-
响应数据
pn
stringUS11205304B2
公开(公告)号
patent_id
string718ead9c-4f3c-4674-8f5a-24e126827269
专利Id
legal_date
integer<int32>20151027
法律状态更新日期
patent_legal
objectPlease check the form: PatentLegalStatus
法律信息
event_status
array[ "Transfer" ]
法律事件

如：权利转移-Transfer，许可-License，质押/担保-Pledge，信托-Trust，异议-Opposition，复审-Re-examination，海关备案-Customs，诉讼-Litigation，保全-Preservation，无效程序-Invalid-procedure，口头审理-Oral-procedure，国防解密-Declassification，一案双申-Double application

legal_status
array[ "Examining" ]
法律状态

如：公开-Published，实质审查-Examining，授权-Granted，避重授权-Double，放弃-未指定类型-Abandoned-Undetermined，放弃-主动放弃-Abandoned-Voluntarily，放弃-视为放弃-Abandoned-Deemed，撤回-未指定类型-Withdrawn-Undetermined，撤回-主动撤回-Withdrawn-Voluntarily，撤回-视为撤回-Withdrawn-Deemed，驳回-Rejected，全部撤销-Revoked，期限届满-Expired，未缴年费-Non-Payment，权利恢复-Restoration，权利终止-Ceased，部分无效-P-Revoked，申请终止-Discontinuation，PCT国际公布-PCT published，PCT进入指定国（指定期内）-PCT entering(designated period)，PCT进入指定国（指定期满）-PCT entering(designated expiration)，PCT未进指定国-PCT unentered

simple_legal_status
array[ "Pending" ]
简单法律状态

如：失效-Inactive，有效-Active，审中-Pending，未确认-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",
      "legal_date": 20151027,
      "patent_legal": {
        "event_status": [
          "Transfer"
        ],
        "legal_status": [
          "Examining"
        ],
        "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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms