CMA 中华医学会文献检索 API

通过中华医学会 Yiigle 官方网关检索中文医学文献，覆盖《中华内科杂志》《中华消化内镜杂志》等核心中文医学刊源。返回字段统一映射为 SearchResponse，与 Google Scholar / PubMed / 万方数据保持一致。

POST/v1/cma/search

CMA 文献检索

POST/v1/cma/search

提交中英文医学关键词调用中华医学会 Yiigle 网关，支持作者、期刊、年份范围过滤。网关仅识别 YYYY 年份格式，YYYY-MM / YYYY-MM-DD 等会被自动规整为年份。

参数

参数	类型	必填	描述
`query`	string	必填	搜索关键词（中英文均可），1-300 字符
`size`	integer	可选 (默认: 20)	返回结果数量，1-50，默认 20
`page`	integer	可选 (默认: 0)	分页页码（从 0 开始），默认 0
`author`	string	可选	按作者姓名过滤（可选）
`journal`	string	可选	按期刊名称过滤（可选）
`date_from`	string	可选	起始年份过滤。接受 YYYY / YYYY-MM / YYYY-MM-DD —— 非年份输入会自动规整为 YYYY
`date_to`	string	可选	截止年份过滤，规则同 date_from
`sort`	string	可选	排序表达式（默认 'artPubYear:desc;artId:desc'，按发表年份倒序）

响应

Response

{
  "success": true,
  "message": "CMA search completed successfully",
  "query": "高血压",
  "results": {
    "total": 10,
    "source": "CMA"
  },
  "data": [
    {
      "source": "CMA",
      "title": "原发性高血压的临床诊治进展",
      "authors": [
        "张三",
        "李四"
      ],
      "abstract": "本研究系统综述了原发性高血压的诊断与治疗进展……",
      "publication_year": "2024",
      "publication_journal": "中华心血管病杂志",
      "id": "1004-xxxx-xxxxxx",
      "doi": "10.3760/cma.j.cn112148-20240101-00001",
      "source_url": "https://rs.yiigle.com/cmaid/12345",
      "categories": [
        "高血压",
        "心血管疾病",
        "诊治"
      ],
      "volume": "52",
      "issue": "3",
      "pages": "210-217"
    }
  ]
}

响应

Response

{
  "success": true,
  "message": "CMA search completed successfully",
  "query": "高血压",
  "results": {
    "total": 10,
    "source": "CMA"
  },
  "data": [
    {
      "source": "CMA",
      "title": "原发性高血压的临床诊治进展",
      "authors": [
        "张三",
        "李四"
      ],
      "abstract": "本研究系统综述了原发性高血压的诊断与治疗进展……",
      "publication_year": "2024",
      "publication_journal": "中华心血管病杂志",
      "id": "1004-xxxx-xxxxxx",
      "doi": "10.3760/cma.j.cn112148-20240101-00001",
      "source_url": "https://rs.yiigle.com/cmaid/12345",
      "categories": [
        "高血压",
        "心血管疾病",
        "诊治"
      ],
      "volume": "52",
      "issue": "3",
      "pages": "210-217"
    }
  ]
}

示例

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.qinyanai.com"

# CMA literature search (中华医学会 Yiigle)
response = requests.post(
    f"{BASE_URL}/v1/cma/search",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "query": "高血压",
        "size": 10,
        "page": 0,
        "date_from": "2020",
        "date_to": "2025"
    }
)
data = response.json()
for paper in data["data"]:
    print(f"{paper['title']} - {paper['publication_journal']} ({paper['publication_year']})")