开放接口文档

千方医数集站点公开接口：免登录 · GET · 明文 JSON，支持页面内在线调试。供 AI 读取的 Markdown 版本： Markdown 版 →

通用约定

统一响应包装

{ "yesenc": false, "code": "E0", "message": "执行操作成功", "data": <业务数据> }

错误码

code	说明
`E0`	成功，业务数据在 data
`E1`	一般错误 / 无数据记录（slug 反查不到、必填参数缺失等），详见 message

接口目录

URL地址反查ID

提交数据集详情页 URL（或仅末段 slug），反查该详情页对应的数据集记录 ID。用于数据维护人员按 sitemap/页面 URL 定位记录后做更新操作。slug 撞车（多条同名）时返回全部命中，由调用方按分类/名称核对认领。请求头须携带维护令牌 X-Maintenance-Token（固定值，由站点方单独提供）；缺失或不匹配返回 E1「鉴权失败：令牌无效」。

URL地址https://www.qianfanghub.com/medical-api/medicalDataset/queryRecordIdBySlug

提交方式GET·表单类型application/x-www-form-urlencoded（Query 参数传输）

提交参数

名称	类型	长度	必填	说明
`（请求头）X-Maintenance-Token`	String	—	是	维护令牌请求头（固定值，由站点方单独提供）；缺失或不匹配返回 E1「鉴权失败：令牌无效」
`url`	String	1024	是	详情页完整 URL 或仅末段数据集 slug，两种形态都收；兼容 % 编码形态与携带 query 串

响应参数

响应 data 为命中记录数组（slug 撞车时多条；无命中返回 E1「无数据记录」），以下为数组元素字段：

名称	类型	说明
`recordId`	Long	记录 ID（数据集主表 cs_medical_disease_dataset 主键）
`datasetNameCn`	String	数据集中文名（核对用）
`datasetNameEn`	String	数据集英文名
`firstLevelName`	String	所属一级分类（中文）
`secondLevelName`	String	所属二级分类（中文）

样例说明

请求示例

curl -G 'https://www.qianfanghub.com/medical-api/medicalDataset/queryRecordIdBySlug' \
  -H 'X-Maintenance-Token: <维护令牌>' \
  --data-urlencode 'url=https://www.qianfanghub.com/dataset/cardiovascular-diseases/cardiovascular-diseases-other/bp-monitor-reading-medical-device-images-血压计读数-医疗设备图像'

响应示例

{
  "yesenc": false,
  "code": "E0",
  "data": [
    {
      "recordId": 20697,
      "datasetNameCn": "血压计读数 | 医疗设备图像",
      "datasetNameEn": "BP Monitor Reading | Medical Device Images",
      "secondLevelName": "其他",
      "firstLevelName": "心血管系统疾病"
    }
  ],
  "message": "执行操作成功"
}

在线调试

URL地址

https://www.qianfanghub.com/medical-api/medicalDataset/queryRecordIdBySlug?url=https%3A%2F%2Fwww.qianfanghub.com%2Fdataset%2Fcardiovascular-diseases%2Fcardiovascular-diseases-other%2Fbp-monitor-reading-medical-device-images-%E8%A1%80%E5%8E%8B%E8%AE%A1%E8%AF%BB%E6%95%B0-%E5%8C%BB%E7%96%97%E8%AE%BE%E5%A4%87%E5%9B%BE%E5%83%8F

提交参数JSON