在哪里可以找到 [C027]企业专利风险预警的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1company~1enterprise-patent-risk-warning/post，也可在 /openapi.json 浏览完整规范。

[C027]企业专利风险预警

Q: [C027]企业专利风险预警 的接口地址是什么？

[C027]企业专利风险预警 的接口为 POST https://connect.zhihuiya.com/company/enterprise-patent-risk-warning。

Q: [C027]企业专利风险预警 可以返回哪些数据？

[C027]企业专利风险预警：该接口提供全球科创企业的专利风险预警数据，包含专利的质押诉讼、转入转出、驳回无效等。 全球科创企业指覆盖满足以下条件之一的企业，①有专利申请或拥有专利，②有风险融资记录，③有科技资质的（高新技术企业、科技型中小企业等），④上市企业，⑤科技实力强的集团新成立的子公司。 。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://connect.zhihuiya.com/company/enterprise-patent-risk-warning

在体验中心中试用

该接口提供全球科创企业的专利风险预警数据，包含专利的质押诉讼、转入转出、驳回无效等。

全球科创企业指覆盖满足以下条件之一的企业，①有专利申请或拥有专利，②有风险融资记录，③有科技资质的（高新技术企业、科技型中小企业等），④上市企业，⑤科技实力强的集团新成立的子公司。

company_name、credit_code、org_number三者必填其一，同时填写则以credit_code 为准，其次org_number，最后以company_name为准。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`company_name`	`string`	`小米科技有限责任公司`	查询企业名称，单个查询
`credit_code`	`string`	`91110108551385082Q`	查询企业的统一社会信用代码，单个查询
`org_number`	`string`	`5513850T82`	查询企业的组织机构代码，单个查询

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`org_number`	`string`	`05669441-9`	组织机构代码
`credit_code`	`string`	`913205940566944300`	社会统一信用代码
`company_name`	`string`	`苏州瀚川智能科技股份有限公司`	企业名称
`patent_count`	`object`	`Please check the form: PatentCount`	专利统计信息
`apno_cnt`	`integer<int32>`	`481`	专利申请数量
`rejected`	`integer<int32>`	-	专利被驳回数量
`patent_pledge`	`integer<int32>`	-	质押的专利数量
`patent_reexam`	`integer<int32>`	-	被无效的专利数量
`patent_transfer`	`integer<int32>`	`21`	转入的专利数量
`patent_transfer_out`	`integer<int32>`	-	转出的专利数量
`active_invention_cnt`	`integer<int32>`	`25`	有效的授权发明专利数量
`granted_invention_cnt`	`integer<int32>`	`25`	授权的发明专利数量
`patent_litigation_defendant`	`integer<int32>`	-	涉诉专利中被诉方的专利数量
`patent_litigation_plaintiff`	`integer<int32>`	-	涉诉专利中的原诉方的专利数量
`patent_event_count`	`object`	`Please check the form: PatentEventCount`	专利事件信息
`pledge`	`integer<int32>`	-	专利被质押事件数量
`reexam`	`integer<int32>`	-	专利被无效事件数量
`transfer`	`integer<int32>`	`21`	专利转入事件数量
`transfer_out`	`integer<int32>`	-	专利转出事件数量
`litigation_defendant`	`integer<int32>`	-	涉诉专利中被诉方的专利事件数量
`litigation_plaintiff`	`integer<int32>`	-	涉诉专利中原诉方的专利事件数量
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "org_number": "05669441-9",
    "credit_code": 913205940566944300,
    "company_name": "苏州瀚川智能科技股份有限公司",
    "patent_count": {
      "apno_cnt": 481,
      "rejected": 0,
      "patent_pledge": 0,
      "patent_reexam": 0,
      "patent_transfer": 21,
      "patent_transfer_out": 0,
      "active_invention_cnt": 25,
      "granted_invention_cnt": 25,
      "patent_litigation_defendant": 0,
      "patent_litigation_plaintiff": 0
    },
    "patent_event_count": {
      "pledge": 0,
      "reexam": 0,
      "transfer": 21,
      "transfer_out": 0,
      "litigation_defendant": 0,
      "litigation_plaintiff": 0
    }
  },
  "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`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found
`68300012`	企业数据不存在

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms