[B048] 药物临床结果分组信息的接口地址是什么？

[B048] 药物临床结果分组信息的接口为 GET https://connect.zhihuiya.com/synapse/ct-result/group。

[B048] 药物临床结果分组信息可以返回哪些数据？

[B048] 药物临床结果分组信息：通过临床结果ID获取临床结果分组数据。完整响应结构请参见本页的响应结构与成功响应示例。

在哪里可以找到 [B048] 药物临床结果分组信息的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1synapse~1ct-result~1group/get，也可在 /openapi.json 浏览完整规范。

[B048] 药物临床结果分组信息

Q: [B048] 药物临床结果分组信息 是什么？

通过临床结果ID获取临床结果分组数据

Q: [B048] 药物临床结果分组信息 的接口地址是什么？

[B048] 药物临床结果分组信息 的接口为 GET https://connect.zhihuiya.com/synapse/ct-result/group。

get

https://connect.zhihuiya.com/synapse/ct-result/group

在体验中心中试用

通过临床结果ID获取临床结果分组数据

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`ct_result_id`	`string`	`5adee5585028aaa5da5982d22a808a99`	临床结果ID，通过临床结果检索接口获取

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`groups`	`array`	`[ { "group_id": "854d42290a95a38d05d90422e5392822", "group_type": "outcome_group", "ct_result_id": "a452da8e32d890452d5ea82ee823d8e5", "characteristic": [ { "name": "Tocilizumab", "type": "drug" } ] } ]`	分组信息
`group_id`	`string`	`e2e088e8e8aeda8aa2a2924ee3a59828`	临床结果分组ID
`group_type`	`string`	`outcome_group`	临床结果分组类型
`ct_result_id`	`string`	`5adee5585028aaa5da5982d22a808a99`	临床结果ID
`characteristic`	`array`	`[ { "name": "Tocilizumab", "type": "drug" } ]`	临床结果分组特征和用药方案
`name`	`string`	`Sotorasib`	分组特征或用药方案名称
`type`	`string`	`drug`	分组特征或用药方案类型
`participant_number`	`string`	`7`	临床结果分组评价人数
`outcome_measures`	`array`	`[ { "name": "CRP levels", "measure_id": "M1", "result_list": [ { "value": "4.6", "group_id": "854d42290a95a38d05d90422e5392822" } ], "ct_result_id": "a452da8e32d890452d5ea82ee823d8e5", "display_name": [ { "lang": "EN", "name": "CRP levels" }, { "lang": "CN", "name": "CRP levels" } ], "outcome_order": 1, "unit_of_measure": "mg/L" } ]`	指标信息
`name`	`string`	`Maximum Observed Plasma Concentration (Cmax) of Sotorasib`	指标名称
`type`	`string`	`Primary`	指标类型
`measure_id`	`string`	`M1`	指标ID
`param_type`	`string`	`Geometric Mean`	参数类型
`result_list`	`array`	`[ { "value": "4.6", "group_id": "854d42290a95a38d05d90422e5392822" } ]`	指标数值
`pct`	`string`	`20`	评价结果结果（百分比）
`value`	`string`	`5080`	评价结果结果（数值）
`spread`	`string`	`108.5`	评价结果结果（离散值）
`group_id`	`string`	`e2e088e8e8aeda8aa2a2924ee3a59828`	评价结果分组ID
`lower_value`	`string`	`0.1`	评价结果结果（下限）
`upper_value`	`string`	`0.5`	评价结果结果（上限）
`participant_analyzed`	`string`	`7`	评价结果分析人数
`participant_analyzed_units`	`string`	`Participants`	评价结果分组人数单位
`ct_result_id`	`string`	`5adee5585028aaa5da5982d22a808a99`	临床结果ID
`display_name`	`array`	`[ { "lang": "EN", "name": "CRP levels" }, { "lang": "CN", "name": "CRP levels" } ]`	指标展示名称
`lang`	`string`	`EN`	语言
`name`	`string`	`Ranibizumab (Genentech)`	药物、靶点、机构、适应症、国家/地区、字典、作用机制名称
`normalized_id`	`array`	`[ "9410c1945fa14130b1a205394e3c2361" ]`	指标标准ID
`outcome_order`	`integer<int32>`	`1`	指标排序
`dispersion_type`	`string`	`Geometric Coefficient of Variation`	指标离差类型
`display_section`	`string`	`Adverse Event`	展示模块
`unit_of_measure`	`string`	`ng/mL`	指标单位
`parent_measure_id`	`string`	`OE1`	父级指标ID
`outcome_measure_safety`	`array`	`[ { "name": "CRP levels", "measure_id": "M1", "result_list": [ { "value": "4.6", "group_id": "854d42290a95a38d05d90422e5392822" } ], "ct_result_id": "a452da8e32d890452d5ea82ee823d8e5", "display_name": [ { "lang": "EN", "name": "CRP levels" }, { "lang": "CN", "name": "CRP levels" } ], "outcome_order": 1, "unit_of_measure": "mg/L" } ]`	安全性指标信息
`outcome_measure_efficacy`	`array`	`[ { "name": "CRP levels", "measure_id": "M1", "result_list": [ { "value": "4.6", "group_id": "854d42290a95a38d05d90422e5392822" } ], "ct_result_id": "a452da8e32d890452d5ea82ee823d8e5", "display_name": [ { "lang": "EN", "name": "CRP levels" }, { "lang": "CN", "name": "CRP levels" } ], "outcome_order": 1, "unit_of_measure": "mg/L" } ]`	有效性指标信息
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "groups": [
      {
        "group_id": "e2e088e8e8aeda8aa2a2924ee3a59828",
        "group_type": "outcome_group",
        "ct_result_id": "5adee5585028aaa5da5982d22a808a99",
        "characteristic": [
          {
            "name": "Sotorasib",
            "type": "drug"
          }
        ],
        "participant_number": 7
      }
    ],
    "outcome_measures": [
      {
        "name": "Maximum Observed Plasma Concentration (Cmax) of Sotorasib",
        "type": "Primary",
        "measure_id": "M1",
        "param_type": "Geometric Mean",
        "result_list": [
          {
            "pct": 20,
            "value": 5080,
            "spread": 108.5,
            "group_id": "e2e088e8e8aeda8aa2a2924ee3a59828",
            "lower_value": 0.1,
            "upper_value": 0.5,
            "participant_analyzed": 7,
            "participant_analyzed_units": "Participants"
          }
        ],
        "ct_result_id": "5adee5585028aaa5da5982d22a808a99",
        "display_name": [
          {
            "lang": "EN",
            "name": "Ranibizumab (Genentech)"
          }
        ],
        "normalized_id": [
          "9410c1945fa14130b1a205394e3c2361"
        ],
        "outcome_order": 1,
        "dispersion_type": "Geometric Coefficient of Variation",
        "display_section": "Adverse Event",
        "unit_of_measure": "ng/mL",
        "parent_measure_id": "OE1"
      }
    ],
    "outcome_measure_safety": [
      {
        "name": "Maximum Observed Plasma Concentration (Cmax) of Sotorasib",
        "type": "Primary",
        "measure_id": "M1",
        "param_type": "Geometric Mean",
        "result_list": [
          {
            "pct": 20,
            "value": 5080,
            "spread": 108.5,
            "group_id": "e2e088e8e8aeda8aa2a2924ee3a59828",
            "lower_value": 0.1,
            "upper_value": 0.5,
            "participant_analyzed": 7,
            "participant_analyzed_units": "Participants"
          }
        ],
        "ct_result_id": "5adee5585028aaa5da5982d22a808a99",
        "display_name": [
          {
            "lang": "EN",
            "name": "Ranibizumab (Genentech)"
          }
        ],
        "normalized_id": [
          "9410c1945fa14130b1a205394e3c2361"
        ],
        "outcome_order": 1,
        "dispersion_type": "Geometric Coefficient of Variation",
        "display_section": "Adverse Event",
        "unit_of_measure": "ng/mL",
        "parent_measure_id": "OE1"
      }
    ],
    "outcome_measure_efficacy": [
      {
        "name": "Maximum Observed Plasma Concentration (Cmax) of Sotorasib",
        "type": "Primary",
        "measure_id": "M1",
        "param_type": "Geometric Mean",
        "result_list": [
          {
            "pct": 20,
            "value": 5080,
            "spread": 108.5,
            "group_id": "e2e088e8e8aeda8aa2a2924ee3a59828",
            "lower_value": 0.1,
            "upper_value": 0.5,
            "participant_analyzed": 7,
            "participant_analyzed_units": "Participants"
          }
        ],
        "ct_result_id": "5adee5585028aaa5da5982d22a808a99",
        "display_name": [
          {
            "lang": "EN",
            "name": "Ranibizumab (Genentech)"
          }
        ],
        "normalized_id": [
          "9410c1945fa14130b1a205394e3c2361"
        ],
        "outcome_order": 1,
        "dispersion_type": "Geometric Coefficient of Variation",
        "display_section": "Adverse Event",
        "unit_of_measure": "ng/mL",
        "parent_measure_id": "OE1"
      }
    ]
  },
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

错误码	描述
`67200001`	API整体限流错误!
`67200002`	用户调用请求限流限制错误!
`67200003`	申请token的key和secret不正确或者状态错误!
`67200004`	无权限或该接口的套餐已超过系统设置的上限!
`67200005`	账户余额不足，调用失败!
`67200006`	客户端已过期，调用失败!
`67200007`	超过调用额度，调用失败!

HTTP 状态码

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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms