更新时间:2025-07-08 GMT+08:00
分享

创建配体相似性图计算任务

功能介绍

创建配体相似性图计算任务。

URI

POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/similarity-graph

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID,您可以从获取项目ID中获取。

约束限制

不涉及

取值范围

仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。

默认取值

不涉及

eihealth_project_id

String

参数解释

空间ID。

约束限制

不涉及

取值范围

仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。

Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。

约束限制

不涉及

取值范围

长度为[1-32768]个字符。

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

mode

String

参数解释

创建配体相似度图的模式。

约束限制

不涉及

取值范围

  • CENTER:中心模式

  • FREE:自由模式

默认取值

不涉及

ligands

Array of CreateLigandSimilarityGraphLigandDto objects

参数解释

配体列表。

约束限制

配体数量范围为[2-101]。

取值范围

不涉及

默认取值

不涉及

表4 CreateLigandSimilarityGraphLigandDto

参数

是否必选

参数类型

描述

name

String

参数解释

配体分子唯一名字,受体中的建议使用“{氨基酸}:{链}:{编号}”。

约束限制

不涉及

取值范围

长度为[1-32]个字符。

默认取值

不涉及

smiles

String

参数解释

分子SMILES表达式。

约束限制

不涉及

取值范围

长度为[1-512]个字符。

默认取值

不涉及

main

Boolean

参数解释

配体是否为主要配体,在中心模式下,必须指定1个主要配体。

约束限制

不涉及

取值范围

不涉及

默认取值

false

响应参数

状态码:201

表5 响应Body参数

参数

参数类型

描述

id

String

参数解释

任务ID。

约束限制

不涉及

取值范围

长度为[1-128]个字符。

默认取值

不涉及

请求示例

创建配体相似性图计算任务,创建模式为CENTER,配体列表为MolA、MolB。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/similarity-graph

{
  "mode" : "CENTER",
  "ligands" : [ {
    "name" : "MolA",
    "smiles" : "c1ccccc1",
    "main" : true
  }, {
    "name" : "MolB",
    "smiles" : "c1ccccc1",
    "main" : false
  } ]
}

响应示例

状态码:201

配体相似度图任务创建成功响应。

{
  "id" : "c05ebc2029c24699af2354f67391604c"
}

状态码

状态码

描述

201

配体相似度图任务创建成功响应。

错误码

请参见错误码

相关文档