[P057]查询监控项更新状态

get
https://connect.zhihuiya.com/patent-alert/check
在体验中心中试用

查询专利监控预警项目有无专利更新。返回监控项目名称，监控项目类型，专利数，专利ID列表。

周查询和月查询建议提前调用接口获取更新数据，以防止影响推送功能，获取的数据是上一次查询时间至当前时间范围内的更新数据。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
alert_id
必填
string7f22ee78764149b481314b1fa60dca0c
监控项目的ID号

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
array-
响应数据
type
stringnew
监控项目的类型
count
integer<int64>1
专利数
alert_name
stringIntelligent bud company monitoring
监控项目名称
patent_ids
array[ "f052da16-1d93-46a6-9174-b653c69fd884" ]
专利的唯一标识
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": [
    {
      "type": "new",
      "count": 1,
      "alert_name": "智慧芽公司监控",
      "patent_ids": [
        "f052da16-1d93-46a6-9174-b653c69fd884"
      ]
    }
  ],
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

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

HTTP 状态码

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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms