[B069] 转化医学检索可以返回哪些数据？

[B069] 转化医学检索：通过药物、靶点、适应症、机构、主题、转化阶段、期刊、会议等字段，获取转化医学相关数据。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [B069] 转化医学检索的 OpenAPI schema？

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

[B069] 转化医学检索

Q: [B069] 转化医学检索 的接口地址是什么？

[B069] 转化医学检索 的接口为 POST https://connect.zhihuiya.com/synapse/translational/medicine/search。

post

https://connect.zhihuiya.com/synapse/translational/medicine/search

在体验中心中试用

通过药物、靶点、适应症、机构、主题、转化阶段、期刊、会议等字段，获取转化医学相关数据

以下查询条件必须存在一个或多个：drug、target、disease、organizations、mechanism、drugType、keywords、subject、translationStage、publicationDate、journal、conference。keywords 参数最多支持20个值。conference的值获取可以参考产品,会议与年份之间需要用空格隔开。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`conference`	`array`	`[ "WCLC 2025", "AACR 2024", "ADA 2025" ]`	会议名称,参考产品会议名称
`disease`	`array`	`[ "f98fd32baa8447119bb87f84093b925c", "74d974da49ba407195b38595a0aff704" ]`	适应症
`drug`	`object`	`Please check the form: DrugFilterAndCondition`	药物,condition默认为OR,支持AND
`condition`	`string`	`OR`	条件,OR或AND
`value`	`array`	`[ "c7a2671dc0574f19bc42d557eca3906f", "9ae626b75273433f8f4203ee3f7aa181" ]`	值列表
`drug_type`	`array`	`[ "6718bf09d6024f4db4f309a4cc791cf6", "6be383aaee904d2b8321e2d1fdacf8bb" ]`	药物类型
`journal`	`array`	`[ "N Engl J Med", "Nat Med" ]`	期刊名称,Nature \| Science \| Cell \| Lancet \| N Engl J Med \| Proc Natl Acad Sci U S A \| Nat Commun \| Nat Genet \| Nat Med \| Sci Transl Med \| J Med Chem
`keywords`	`object`	`Please check the form: KeywordsFilterAndCondition`	关键词
`condition`	`string`	`OR`	条件,OR或AND
`value`	`array`	`[ "Sacituzumab govitecan", "Oral" ]`	值列表
`limit`	`integer<int64>`	`10`	返回条数,默认10。 offset + limit <= 10000, limit最大设置100
`mechanism`	`array`	`[ "cf1cf8ea0f9b80ee88876a3324ceac99", "888b99dda6a62ef2551937c34e253e9c" ]`	作用机制
`offset`	`integer<int64>`	-	偏移量,默认0
`organizations`	`array`	`[ "5c1eb05d43334b6d6d7973ee3073b7b4", "52aee12631589b24dca3ae62de8a0886" ]`	机构
`publication_date`	`object`	`Please check the form: PublicationDateFilter`	发布时间,1:1周内 \| 2:1个月内 \| 3:1年内 \| 4:3年内 \| 5:自定义
`end_date`	`string`	`2024-12-31`	结束时间(自定义时使用)
`start_date`	`string`	`2024-01-01`	开始时间(自定义时使用)
`type`	`integer<int32>`	`4`	时间范围类型,1:1周内 \| 2:1个月内 \| 3:1年内 \| 4:3年内 \| 5:自定义
`sort`	`array`	`Please check the form: SortField`	字段排序,field支持: PUB_DT, order支持desc, asc (默认desc)
`field`	`string`	`PUB_DT`	排序字段,支持: PUB_DT
`order`	`string`	`desc`	排序顺序,desc或asc,默认desc
`subject`	`array`	`[ "3期临床研究" ]`	主题/标签,流行病学\|致病机理\|靶点\|生物标志物\|结构生物学\|药物发现/临床前\|1期临床研究\|1/2期临床研究\|2期临床研究\|2/3期临床研究\|3期临床研究\|上市后研究\|真实世界研究\|新技术
`target`	`object`	`Please check the form: TargetFilterAndCondition`	靶点,condition默认为OR,支持AND
`condition`	`string`	`OR`	条件,OR或AND
`value`	`array`	`[ "d8cdb9ce63174077a9ef868b39bf3421", "c385dcba5fea4e97bf02bc256757613a" ]`	值列表
`translation_stage`	`array`	`[ "T2" ]`	转化阶段,T0 \| T1 \| T2 \| T3

请求示例

该 API 接口的请求体示例

JSON

{
  "drug": {
    "value": [
      "c7a2671dc0574f19bc42d557eca3906f",
      "9ae626b75273433f8f4203ee3f7aa181"
    ],
    "condition": "OR"
  },
  "sort": [
    {
      "field": "PUB_DT",
      "order": "desc"
    }
  ],
  "limit": 10,
  "offset": 0,
  "target": {
    "value": [
      "d8cdb9ce63174077a9ef868b39bf3421",
      "c385dcba5fea4e97bf02bc256757613a"
    ],
    "condition": "OR"
  },
  "disease": [
    "f98fd32baa8447119bb87f84093b925c",
    "74d974da49ba407195b38595a0aff704"
  ],
  "journal": [
    "N Engl J Med",
    "Nat Med"
  ],
  "subject": [
    "3期临床研究"
  ],
  "keywords": {
    "value": [
      "Sacituzumab govitecan",
      "Oral"
    ],
    "condition": "OR"
  },
  "drug_type": [
    "6718bf09d6024f4db4f309a4cc791cf6",
    "6be383aaee904d2b8321e2d1fdacf8bb"
  ],
  "mechanism": [
    "cf1cf8ea0f9b80ee88876a3324ceac99",
    "888b99dda6a62ef2551937c34e253e9c"
  ],
  "conference": [
    "WCLC 2025",
    "AACR 2024",
    "ADA 2025"
  ],
  "organizations": [
    "5c1eb05d43334b6d6d7973ee3073b7b4",
    "52aee12631589b24dca3ae62de8a0886"
  ],
  "publication_date": {
    "type": 4,
    "end_date": "2024-12-31",
    "start_date": "2024-01-01"
  },
  "translation_stage": [
    "T2"
  ]
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`items`	`array`	`Please check the form:TranslationalMedicineSearchDataDetail`	查询结果
`drugs`	`array`	`Please check the form: CommonDrug`	药物
`drug_id`	`string`	`e82b83b42eba4e5ea3f26f8e06081a5a`	药物ID
`display_name`	`array`	`[ { "lang": "EN", "name": "Ranibizumab (Genentech)" }, { "lang": "CN", "name": "雷珠单抗" } ]`	药物名称，引用“CommonName”
`lang`	`string`	`EN`	语言
`name`	`string`	`Ranibizumab (Genentech)`	药物、靶点、机构、适应症、国家/地区、字典、作用机制名称
`title`	`string`	`Novel Biomarker Discovery in Cancer Research`	标题
`disease`	`array`	`Please check the form: CommonDisease`	适应症
`disease_id`	`string`	`06a9082fe1ec4c97bea31d888b9cfdce`	适应症ID
`display_name`	`array`	`[ { "lang": "EN", "name": "Uveitic Macular Edema" }, { "lang": "CN", "name": "葡萄膜炎黄斑水肿" } ]`	适应症名称，引用“CommonName”
`journal`	`object`	`Please check the form: CommonNorIdName`	期刊
`name`	`string`	`Acute Kidney Injury`	名称
`normalized_id`	`string`	`87bfaf037f8e60c9e25595cd98bb27e4`	标准ID
`subject`	`array`	`Please check the form: CommonNorIdName`	主题
`targets`	`array`	`Please check the form: CommonTarget`	靶点
`target_id`	`string`	`1c2067e5ab054a8995f73efcfcf56207`	靶点ID
`short_name`	`array`	`[ { "lang": "EN", "name": "VEGF" } ]`	靶点简称，引用“CommonName”
`display_name`	`array`	`[ { "lang": "EN", "name": "Vascular endothelial growth factor" }, { "lang": "CN", "name": "血管内皮生长因子" } ]`	靶点全称，引用“CommonName”
`drug_type`	`array`	`Please check the form: CommonDictionary`	药物类型
`display_name`	`array`	`[ { "lang": "EN", "name": "Autologous CAR-T" }, { "lang": "CN", "name": "自体CAR-T" } ]`	字典名称
`normalized_id`	`string`	`2fbfdb3e92d942c48cbb0adb79f23526`	字典ID
`technology`	`array`	`Please check the form: CommonNorIdName`	技术
`source_info`	`array`	`Please check the form: TranslationalMedicineSourceInfo`	来源信息
`code`	`string`	`NATURE-2024-001`	编码
`source`	`string`	`Nature`	来源
`patsnap_id`	`string`	`patsnap_1234567890`	PatSnap ID
`source_url`	`string`	`https://www.nature.com/articles/s41586-024-01234-5`	来源URL
`normalized_source_id`	`string`	`368cf867-f484-430e-9530-44f5cccdd973`	标准化来源ID
`normalized_source_category`	`string`	`Journal`	标准化来源类别
`organization`	`array`	`Please check the form: CommonOrganization`	机构
`display_name`	`array`	`[ { "lang": "EN", "name": "Roche Holding AG" }, { "lang": "CN", "name": "罗氏" } ]`	机构名称，引用“CommonName”
`organization_id`	`string`	`87bfaf037f8e60c9e25595cd98bb27e4`	机构ID
`mechanism_action`	`array`	`Please check the form: CommonMechanismAction`	作用机制
`short_name`	`array`	`[ { "lang": "EN", "name": "KRAS G12C inhibitors" }, { "lang": "CN", "name": "KRAS G12C抑制剂" } ]`	作用机制简称
`display_name`	`array`	`[ { "lang": "EN", "name": "GTPase KRas G12C inhibitors" }, { "lang": "CN", "name": "KRAS G12C突变抑制剂" } ]`	作用机制名称
`mechanism_id`	`string`	`27c0848a265e4332836e10d0e8202b4c`	作用机制ID
`publication_date`	`string`	`2024-01-15`	出版日期
`translation_stage`	`array`	`Please check the form: CommonNorIdName`	转化阶段
`translational_medicine_id`	`string`	`tm_1234567890abcdef`	转化医学ID
`limit`	`integer<int64>`	`10`	返回条数
`total`	`integer<int64>`	`10`	总量
`offset`	`integer<int64>`	-	偏移量
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "items": [
      {
        "drugs": [
          {
            "drug_id": "e82b83b42eba4e5ea3f26f8e06081a5a",
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "title": "Novel Biomarker Discovery in Cancer Research",
        "disease": [
          {
            "disease_id": "06a9082fe1ec4c97bea31d888b9cfdce",
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "journal": {
          "name": "Acute Kidney Injury",
          "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
        },
        "subject": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "targets": [
          {
            "target_id": "1c2067e5ab054a8995f73efcfcf56207",
            "short_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "drug_type": [
          {
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "normalized_id": "2fbfdb3e92d942c48cbb0adb79f23526"
          }
        ],
        "technology": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "source_info": [
          {
            "code": "NATURE-2024-001",
            "source": "Nature",
            "patsnap_id": "patsnap_1234567890",
            "source_url": "https://www.nature.com/articles/s41586-024-01234-5",
            "normalized_source_id": "368cf867-f484-430e-9530-44f5cccdd973",
            "normalized_source_category": "Journal"
          }
        ],
        "organization": [
          {
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "organization_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "mechanism_action": [
          {
            "short_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "mechanism_id": "27c0848a265e4332836e10d0e8202b4c"
          }
        ],
        "publication_date": "2024-01-15",
        "translation_stage": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "translational_medicine_id": "tm_1234567890abcdef"
      }
    ],
    "limit": 10,
    "total": 10,
    "offset": 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