[B009] 药物核心专利检索的接口地址是什么？

[B009] 药物核心专利检索的接口为 POST https://connect.zhihuiya.com/synapse/patent/core/search。

[B009] 药物核心专利检索可以返回哪些数据？

[B009] 药物核心专利检索：通过药物获取药物核心专利。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [B009] 药物核心专利检索的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1synapse~1patent~1core~1search/post，也可在 /openapi.json 浏览完整规范。

[B009] 药物核心专利检索

Q: [B009] 药物核心专利检索 是什么？

通过药物获取药物核心专利

Q: [B009] 药物核心专利检索 的接口地址是什么？

[B009] 药物核心专利检索 的接口为 POST https://connect.zhihuiya.com/synapse/patent/core/search。

post

https://connect.zhihuiya.com/synapse/patent/core/search

在体验中心中试用

通过药物获取药物核心专利

药物，药物类型，专利分类，专利技术类型，靶点，适应症，申请(专利权)人ID 等字段必须存在一个或多个

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`offset`	`integer<int64>`	-	偏移量，默认0
`limit`	`integer<int64>`	`10`	返回条数，默认10。 offset + limit <= 10000， limit最大设置1000
`drug`	`object`	`{ "value": [ "945fa31ebe9e41ae912e493aa3324576" ], "condition": "OR" }`	药物，condition默认为OR，支持AND。
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "945fa31ebe9e41ae912e493aa3324576" ]`	值列表
`filter_dto`	`object`	`Please check the form: GetRelatePatentSearchFilterDto`	过滤条件取值来自统计接口的key
`ancs_type`	`array`	`[ "COMPANY" ]`	当前专利申请人类型
`apdt_year`	`array`	`[ "2008" ]`	申请年
`in_facet`	`array`	`[ "CARVEN, GREGORY JOHN" ]`	发明人
`isdt_year`	`array`	`[ "2013" ]`	授权年
`legal_status`	`array`	`[ "3" ]`	法律状态
`patent_assignee`	`array`	`[ "MERCK SHARP & DOHME B.V." ]`	申请(专利权)人
`patent_country`	`array`	`[ "EP" ]`	受理局
`patent_tech_type`	`array`	`[ "3db27f57784548dc96356669deee2ca1" ]`	专利技术类型
`pbdt_year`	`array`	`[ "2013" ]`	公开年
`priority_year`	`array`	`[ "2007" ]`	优先权年
`simple_legal_status`	`array`	`[ "1" ]`	简单法律状态
`legal_status`	`array`	`[ 1, 3 ]`	专利的法律状态 1: 公开 2: 实质审查 3: 授权 8: 避重授权 11: 撤回 13: 驳回 14: 全部撤销 15: 期限届满 16: 未缴年费 21: 权利恢复 22: 权利终止 23: 部分无效 24: 申请终止 30: 放弃 222: PCT国际公布 223: PCT进入指定国(指定期内) 224: PCT进入指定国(指定期满) 225: PCT未进指定国
`sort`	`array`	`[ { "sort_field": "score", "sort_order": "desc" } ]`	字段排序，field支持：score,PBDT_YEARMONTHDAY,APD_YEARMONTHDAY,EXDT_TS；order支持desc, asc（默认desc）
`sort_field`	`string`	`score`	排序字段，枚举值：score,PBDT_YEARMONTHDAY,APD_YEARMONTHDAY,EXDT_TS
`sort_order`	`string`	`desc`	排序方式，支持：desc,asc
`drug_type`	`object`	`{ "value": [ "c38eb408d6b842f487d6a27484156633" ], "condition": "OR" }`	药物类型，condition默认为OR，不支持AND。，通过字典查询接口获取
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "c38eb408d6b842f487d6a27484156633" ]`	值列表
`drug_patent_type`	`string`	`PRODUCT_COMPOUND_SEQUENCE`	专利分类。枚举值：PRODUCT_COMPOUND_SEQUENCE、DRUG_COMBINATION_FORMULATION、PRODUCT_DERIVATIVE、CRYSTAL_FORM、PROCESS、NEW_USE、DOSAGE_FORM、DEVICE、DIAGNOSTIC_ANALYSIS_AND_ASSAY、OTHERS
`patent_tech_type`	`object`	`{ "value": [ "3db27f57784548dc96356669deee2ca1" ], "condition": "OR" }`	专利技术类型，condition默认为OR，不支持AND。，通过字典查询接口获取
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "3db27f57784548dc96356669deee2ca1" ]`	值列表
`disease`	`object`	`{ "value": [ "62eaee6d9ee44410b8aca59dfc7408e9" ], "condition": "OR" }`	适应症，condition默认为OR，不支持AND。
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "62eaee6d9ee44410b8aca59dfc7408e9" ]`	值列表
`target`	`object`	`{ "value": [ "9786d32e3d244a688ec6a60d2fe1b10b" ], "condition": "OR" }`	靶点，condition默认为OR，支持AND。
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "9786d32e3d244a688ec6a60d2fe1b10b" ]`	值列表
`source`	`string`	`MEDSPAL`	信息源。枚举值：FDA_PURPLE_BOOK、FDA_ORANGE_BOOK、CDE、MEDSPAL、VAXPAL、MFDS
`patent_assignee`	`object`	`{ "value": [ "37644001d015f20c92d6232713bd09eb" ], "condition": "OR", "keyword_value": [ "Merck Sharp" ] }`	申请(专利权)人id
`condition`	`string`	`OR`	逻辑运算符，枚举值：AND、OR，大小写敏感。
`value`	`array`	`[ "37644001d015f20c92d6232713bd09eb" ]`	值列表
`keyword_value`	`array`	`[ "Merck Sharp" ]`	关键词列表
`patent_country`	`array`	`[ "EP" ]`	受理局，通过字典查询接口获取
`simple_legal_status`	`array`	`[ "ACTIVE" ]`	简单法律状态。枚举值：INACTIVE、ACTIVE、PENDING、PCT_DESIGNATED_STAGE、PCT_DESIGNATED_STAGE_EXPIRED、UNDETERMINED
`isdt`	`object`	`{ "to": 20240822, "from": 20130101 }`	授权日，格式：yyyyMMdd，如：20240522
`from`	`integer<int64>`	`20130101`	范围起始
`to`	`integer<int64>`	`20240822`	范围截止
`pbdt`	`object`	`{ "to": 20240822, "from": 20130101 }`	公开日，格式：yyyyMMdd，如：20240522
`from`	`integer<int64>`	`20130101`	范围起始
`to`	`integer<int64>`	`20240822`	范围截止
`priority_date`	`object`	`{ "to": 20200822, "from": 20010101 }`	优先权日，格式：yyyyMMdd，如：20240522
`from`	`integer<int64>`	`20010101`	范围起始
`to`	`integer<int64>`	`20240822`	范围截止
`apdt`	`object`	`{ "to": 20090101, "from": 20080101 }`	申请日范围
`from`	`integer<int64>`	`20080101`	范围起始
`to`	`integer<int64>`	`20090101`	范围截止
`exdt`	`object`	`{ "to": 20290101, "from": 20280101 }`	预估到期日
`from`	`integer<int64>`	`20280101`	范围起始
`to`	`integer<int64>`	`20290101`	范围截止
`current_patent_assignee_type`	`array`	`[ "COMPANY" ]`	当前专利申请人类型
`inventor_name`	`array`	`[ "CARVEN, GREGORY JOHN" ]`	发明人

请求示例

该 API 接口的请求体示例

JSON

{
  "apdt": {
    "to": 20090101,
    "from": 20080101
  },
  "drug": {
    "value": [
      "945fa31ebe9e41ae912e493aa3324576"
    ],
    "condition": "OR"
  },
  "exdt": {
    "to": 20290101,
    "from": 20280101
  },
  "isdt": {
    "to": 20240822,
    "from": 20130101
  },
  "pbdt": {
    "to": 20240822,
    "from": 20130101
  },
  "sort": [
    {
      "sort_field": "score",
      "sort_order": "desc"
    }
  ],
  "limit": 10,
  "offset": 0,
  "source": "MEDSPAL",
  "target": {
    "value": [
      "9786d32e3d244a688ec6a60d2fe1b10b"
    ],
    "condition": "OR"
  },
  "disease": {
    "value": [
      "62eaee6d9ee44410b8aca59dfc7408e9"
    ],
    "condition": "OR"
  },
  "drug_type": {
    "value": [
      "c38eb408d6b842f487d6a27484156633"
    ],
    "condition": "OR"
  },
  "filter_dto": {
    "in_facet": [
      "CARVEN, GREGORY JOHN"
    ],
    "ancs_type": [
      "COMPANY"
    ],
    "apdt_year": [
      "2008"
    ],
    "isdt_year": [
      "2013"
    ],
    "pbdt_year": [
      "2013"
    ],
    "legal_status": [
      "3"
    ],
    "priority_year": [
      "2007"
    ],
    "patent_country": [
      "EP"
    ],
    "patent_assignee": [
      "MERCK SHARP & DOHME B.V."
    ],
    "patent_tech_type": [
      "3db27f57784548dc96356669deee2ca1"
    ],
    "simple_legal_status": [
      "1"
    ]
  },
  "legal_status": [
    1,
    3
  ],
  "inventor_name": [
    "CARVEN, GREGORY JOHN"
  ],
  "priority_date": {
    "to": 20240822,
    "from": 20010101
  },
  "patent_country": [
    "EP"
  ],
  "patent_assignee": {
    "value": [
      "37644001d015f20c92d6232713bd09eb"
    ],
    "condition": "OR",
    "keyword_value": [
      "Merck Sharp"
    ]
  },
  "drug_patent_type": "PRODUCT_COMPOUND_SEQUENCE",
  "patent_tech_type": {
    "value": [
      "3db27f57784548dc96356669deee2ca1"
    ],
    "condition": "OR"
  },
  "simple_legal_status": [
    "ACTIVE"
  ],
  "current_patent_assignee_type": [
    "COMPANY"
  ]
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`items`	`array`	`Please check the form:PatentSummaryDto`	查询结果
`pn`	`string`	`CN101610676B`	专利公开（公告）号
`apdt`	`string`	`20150814`	专利申请日
`apno`	`string`	`CN200680056438.5`	专利申请号
`exdt`	`string`	`20151104`	预估到期日
`pbdt`	`string`	`20151104`	专利公开(公告)日
`inventor`	`array`	`[ { "lang": "CN", "name": "冯桂深" }, { "lang": "CN", "name": "云穗生" }, { "lang": "CN", "name": "林韶辉" }, { "lang": "CN", "name": "魏荣宝" }, { "lang": "CN", "name": "段洪艳" }, { "lang": "CN", "name": "魏存乐" }, { "lang": "CN", "name": "申京建" }, { "lang": "CN", "name": "刘亚利" }, { "lang": "CN", "name": "曲毅" } ]`	发明人
`lang`	`string`	`CN`	语言
`name`	`string`	`张三`	名称
`address`	`string`	`Alpharetta, GA`	地址
`title_cn`	`string`	`一种胸腺五肽注射液及其制作方法`	专利中文标题
`title_en`	`string`	`Thymopentin injection and preparation method thereof`	专利英文标题
`isdt_year`	`string`	`2015`	授权年
`patent_id`	`string`	`f00a5247-0886-4ec4-aeae-572b32fe633a`	专利id
`legal_status`	`array`	`[ 1, 3 ]`	专利的法律状态 1: 公开 2: 实质审查 3: 授权 8: 避重授权 11: 撤回 13: 驳回 14: 全部撤销 15: 期限届满 16: 未缴年费 21: 权利恢复 22: 权利终止 23: 部分无效 24: 申请终止 30: 放弃 222: PCT国际公布 223: PCT进入指定国(指定期内) 224: PCT进入指定国(指定期满) 225: PCT未进指定国
`priority_year`	`array`	`[ "2015" ]`	优先权年
`inventor_other`	`array`	`[ { "lang": "EN", "name": "FENG GUISHEN" }, { "lang": "EN", "name": "YUN SUISHENG" }, { "lang": "EN", "name": "LIN SHAOHUI" }, { "lang": "EN", "name": "WEI RONGBAO" }, { "lang": "EN", "name": "DUAN HONGYAN" }, { "lang": "EN", "name": "WEI CUNLE" }, { "lang": "EN", "name": "SHEN JINGJIAN" }, { "lang": "EN", "name": "LIU YALI" }, { "lang": "EN", "name": "QU YI" } ]`	发明人
`current_assignee`	`array`	`[ { "entity_id": "7d2ce3422e13151f3260bfc6815fd2ec", "display_name_cn": "北京世桥生物制药有限公司", "display_name_en": "Beijing Sciecure Pharmaceutical Co., Ltd." } ]`	当前申请人
`entity_id`	`string`	`7d2ce3422e13151f3260bfc6815fd2ec`	机构id
`display_name_cn`	`string`	`北京世桥生物制药有限公司`	机构中文名称
`display_name_en`	`string`	`Beijing Sciecure Pharmaceutical Co., Ltd.`	机构英文名称
`original_assignee`	`array`	`[ { "entity_id": "7d2ce3422e13151f3260bfc6815fd2ec", "display_name_cn": "北京世桥生物制药有限公司", "display_name_en": "Beijing Sciecure Pharmaceutical Co., Ltd." } ]`	原始申请人
`limit`	`integer<int64>`	`10`	返回条数
`total`	`integer<int64>`	-	总量
`offset`	`integer<int64>`	-	偏移量
`uncollapse_total`	`integer<int64>`	-	未折叠的专利数量
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "items": [
      {
        "pn": "CN101610676B",
        "apdt": 20150814,
        "apno": "CN200680056438.5",
        "exdt": 20151104,
        "pbdt": 20151104,
        "inventor": [
          {
            "lang": "CN",
            "name": "张三",
            "address": "Alpharetta, GA"
          }
        ],
        "title_cn": "一种胸腺五肽注射液及其制作方法",
        "title_en": "Thymopentin injection and preparation method thereof",
        "isdt_year": 2015,
        "patent_id": "f00a5247-0886-4ec4-aeae-572b32fe633a",
        "legal_status": [
          1,
          3
        ],
        "priority_year": [
          "2015"
        ],
        "inventor_other": [
          {
            "lang": "CN",
            "name": "张三",
            "address": "Alpharetta, GA"
          }
        ],
        "current_assignee": [
          {
            "entity_id": "7d2ce3422e13151f3260bfc6815fd2ec",
            "display_name_cn": "北京世桥生物制药有限公司",
            "display_name_en": "Beijing Sciecure Pharmaceutical Co., Ltd."
          }
        ],
        "original_assignee": [
          {
            "entity_id": "7d2ce3422e13151f3260bfc6815fd2ec",
            "display_name_cn": "北京世桥生物制药有限公司",
            "display_name_en": "Beijing Sciecure Pharmaceutical Co., Ltd."
          }
        ]
      }
    ],
    "limit": 10,
    "total": 0,
    "offset": 0,
    "uncollapse_total": 0
  },
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

错误码	描述
`67200000`	API整体限流错误!
`67200001`	API整体限流错误！
`67200002`	当前调用速率过快,超过当前配置限制QPS！
`67200003`	申请token的key和secret传参不正确或者客户端已被禁用！
`67200004`	请求的接口无权限请联系我们的支持人员！
`67200005`	账户余额/调用次数不足！
`67200006`	客户端超过开通有效期！
`67200007`	当前调用超过当天配置使用额度！
`67200008`	请检查query参数中必填的apikey是否传输！
`67200009`	apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
`67200012`	请求不合法！
`67200100`	当前服务器状态正忙,请求响应超时！
`67200101`	当前请求的Api不存在请检查请求Path！

HTTP 状态码

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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms