[P041]简单法律状态
可以通过输入patent_id或patent_number查询具体某条专利的简单法律状态信息，包含有效、审中、失效、未确认、PCT指定期内、PCT指定期满。详细内容可以查看开发者文档中返回字段说明。
专利id和公开号两个参数必须要有一个，如果两个都存在，会优先使用专利id。
该接口支持批量请求，上限为100条，请求参数相互之间用英文,隔开。批量请求在进行流量/费用扣减的时候，会根据返回结果的成功条数进行多次扣减。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | 718ead9c-4f3c-4674-8f5a-24e126827269 | 专利id |
| string | US11205304B2 | 公开公告号 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | array | - | 响应数据 |
pn | string | US11205304B2 | 公开(公告)号 |
patent_id | string | 718ead9c-4f3c-4674-8f5a-24e126827269 | 专利Id |
simple_legal_status | array | [
"审中"
] | 简单法律状态 如：有效-Active，审中-Pending，失效-Inactive，未确认-Undetermined，PCT指定期内-PCT designated period，PCT指定期满-PCT designated expiration |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect！ | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": [
{
"pn": "US11205304B2",
"patent_id": "718ead9c-4f3c-4674-8f5a-24e126827269",
"simple_legal_status": [
"审中"
]
}
],
"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 | 请求成功 |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms