在哪里可以找到 [A105]企业专利总申请布局的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1insights-company~1patent-portfolio-overview/get，也可在 /openapi.json 浏览完整规范。

[A105]企业专利总申请布局

Q: [A105]企业专利总申请布局 的接口地址是什么？

[A105]企业专利总申请布局 的接口为 GET https://connect.zhihuiya.com/insights-company/patent-portfolio-overview。

Q: [A105]企业专利总申请布局 可以返回哪些数据？

[A105]企业专利总申请布局：分析该公司总体专利布局的数量情况。PCT申请量在一定程度上反应企业在专利全球化布局的策略，通常数量越多，企业越注重全球化布局。多边专利申请则代表着企业较为重要的专利，企业拥有重要专利的数量一定程度上可以反应其技术实力。。完整响应结构请参见本页的响应结构与成功响应示例。

get

https://connect.zhihuiya.com/insights-company/patent-portfolio-overview

在体验中心中试用

分析该公司总体专利布局的数量情况。PCT申请量在一定程度上反应企业在专利全球化布局的策略，通常数量越多，企业越注重全球化布局。多边专利申请则代表着企业较为重要的专利，企业拥有重要专利的数量一定程度上可以反应其技术实力。

国内企业：请填写company_name、credit_code或org_number，三者必填其一，同时填写则以 credit_code 为准，其次org_number，最后以company_name为准。

国外企业：请填写完整的company_name以获得企业分析报告信息。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`company_name`	`string`	`华为技术有限公司`	查询企业名称，单个查询
`org_number`	`string`	`192203821`	查询企业的组织机构代码，单个查询
`credit_code`	`string`	`914403001922038216`	查询企业的统一社会信用代码，单个查询
`apply_start_time`	`string`	`2010`	专利申请起始时间，格式:yyyy
`apply_end_time`	`string`	`2020`	专利申请截止时间，格式:yyyy
`public_start_time`	`string`	`2010`	专利公开起始时间，格式:yyyy
`public_end_time`	`string`	`2020`	专利公开截止时间，格式:yyyy
`simple_legal_status`	`string`	`1 OR 2`	专利的简单法律状态: 0-失效 1-有效 2-审中 220-PCT指定期满 221-PCT指定期内 999-未确认可以多选，多个内容项之间用OR拼接（参数和OR之间有空格）
`patent_type`	`string`	`A OR B`	专利的申请类型 A: 发明申请 B: 授权发明 U: 实用新型 D: 外观设计可以多选，多个内容项之间用OR拼接（参数和OR之间有空格）
`authority`	`string`	`CN OR EP`	选择专利的受理局，如CN、US、EP、JP等，具体可以参考https://analytics.zhihuiya.com/status。默认查询全部数据。搜索专利受理局代码，多个代码可以用逻辑符OR连接例如输入：US OR EP

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`pct_application`	`integer<int32>`	`32`	PCT申请量，按申请号去重
`total_application`	`integer<int32>`	`1000`	企业总申请量
`currently_active_patents`	`integer<int32>`	`12`	有效专利量
`multilateral_application`	`integer<int32>`	`100`	同一个简单同族中，受理局超过2个以上国家/地区/组织的，按简单同族去重
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "pct_application": 32,
    "total_application": 1000,
    "currently_active_patents": 12,
    "multilateral_application": 100
  },
  "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`	请求成功

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms