量表详情接口

GET /api/v1/scales/{id}

获取指定ID的量表详细信息，包括量表名称、版本、作者、评分说明、问题列表等。

接口说明

该接口用于获取系统中指定ID的量表详细信息。返回的数据包括量表的基本信息、评分说明、问题列表等完整内容。

请求参数

参数名 类型 位置 必填 说明
id string path 是 量表ID，用于唯一标识一个量表

响应参数

参数名 类型 说明
id string 量表ID
name string 量表名称
description string 量表描述
version string 量表版本号
categories array 量表分类列表
categories[].id string 分类ID
categories[].name string 分类名称
categories[].description string 分类描述
items array 问题列表
items[].id string 问题ID
items[].question string 问题内容
items[].type string 问题类型
items[].categoryId string 所属分类ID
items[].required boolean 是否必填
items[].description string 问题描述
items[].options array 选项列表
items[].options[].value string 选项值
items[].options[].score integer 选项分数
metadata object 量表元数据
metadata.author string 作者
metadata.createTime string 创建时间
metadata.updateTime string 更新时间
metadata.reference string 参考文献
metadata.scoring object 评分说明
metadata.scoring.description string 评分描述
metadata.scoring.interpretation object 分数解释

响应示例

{
    "id": "phq9",
    "name": "PHQ-9抑郁症筛查量表",
    "description": "PHQ-9是一个用于筛查、诊断和监测抑郁症严重程度的9项量表",
    "version": "1.0.0",
    "categories": [
        {
            "id": "symptoms",
            "name": "症状评估",
            "description": "评估抑郁症状的严重程度"
        }
    ],
    "items": [
        {
            "id": "1",
            "question": "做事时提不起劲或没有兴趣",
            "type": "single_choice",
            "categoryId": "symptoms",
            "required": true,
            "description": "在过去两周内，您是否经常感到做事时提不起劲或没有兴趣？",
            "options": [
                {
                    "value": "完全不会",
                    "score": 0
                },
                {
                    "value": "几天",
                    "score": 1
                },
                {
                    "value": "一半以上的天数",
                    "score": 2
                },
                {
                    "value": "几乎每天",
                    "score": 3
                }
            ]
        }
    ],
    "metadata": {
        "author": "医疗数据标准委员会",
        "createTime": "2024-01-01T00:00:00Z",
        "updateTime": "2024-01-01T00:00:00Z",
        "reference": "PHQ-9: Depression screening tool",
        "scoring": {
            "description": "总分范围0-27分，分数越高表示抑郁症状越严重",
            "interpretation": {
                "0-4": "无或极轻微抑郁",
                "5-9": "轻度抑郁",
                "10-14": "中度抑郁",
                "15-19": "中重度抑郁",
                "20-27": "重度抑郁"
            }
        }
    }
}

错误码

错误码 说明
404 量表不存在
500 服务器内部错误

相关接口