文档首页/ AI科学计算服务/ API参考/ API/ 小分子药物设计/ 药物通用接口/ 查询配体文件预览任务
更新时间：2025-07-08 GMT+08:00
查看PDF
分享

查询配体文件预览任务

功能介绍

查询配体文件预览任务。

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/preview/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

eihealth_project_id

是

String

参数解释：

空间ID。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

task_id

是

String

参数解释：

任务ID，通过创建任务接口取得。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释：

任务状态。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

result

LigandPreviewTaskResultDto object

配体预览任务结果。
表4 LigandPreviewTaskResultDto

参数

参数类型

描述

count

Integer

参数解释：

配体预览任务结果。

约束限制：

如果has_more为false则表该配体文件含有count数量个配体；如果has_more为true则表示该配体文件含有大于count数量个配体（即count不完全统计）；例如：count=100且has_more=true，则表示该配体文件含有“100+个”小分子。

取值范围：

0-1000000

默认取值：

不涉及

ligands

Array of LigandPreviewInfoDto objects

参数解释：

预览配体信息列表。

约束限制：

数量范围为[0-1000]。

取值范围：

不涉及

默认取值：

不涉及

has_more

Boolean

参数解释：

文件中是否还有更多配体没有处理，即当前数量是否表示整个文件的配体数量。

约束限制：

不涉及

取值范围：

  • true：该配体文件含有大于count数量个配体（即count不完全统计），例如：count=100且has_more=true，则表示该配体文件含有100+个小分子。

  • false：该配体文件含有count数量个配体。

默认取值：

不涉及
表5 LigandPreviewInfoDto

参数

参数类型

描述

index

Integer

参数解释：

配体索引（从0起编号）。

约束限制：

不涉及

取值范围：

0-999

默认取值：

不涉及

name

String

参数解释：

配体名称，如果无名称则自动命名，格式为UNK+索引（从1起编号）。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

success

Boolean

参数解释：

解析是否成功。

约束限制：

不涉及

取值范围：

  • true：成功

  • false：失败

默认取值：

不涉及

smiles

String

参数解释：

分子SMILES表达式。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

formula

String

参数解释：

配体分子的化学式。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

is_3d

Boolean

参数解释：

标识原始数据是否为3D。

约束限制：

不涉及

取值范围：

  • true：原始数据为3D。

  • false：原始数据不为3D。

默认取值：

不涉及

structure

LigandStructureDto object

参数解释：

配体3D结构。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

reason

String

参数解释：

解析失败的理由。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及
表6 LigandStructureDto

参数

参数类型

描述

format

String

参数解释：

配体格式，即文件后缀名。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

compressed

Boolean

参数解释：

是否压缩。

约束限制：

不涉及

取值范围：

  • true：压缩

  • false：不压缩

默认取值：

false

data

String

参数解释：

结构数据。

约束限制：

如果压缩则需要解码、解压处理（ASCII Encode -> Base64 Decode -> GZip Inflate -> UTF-8 Decode），以得到原始字符串；如果未压缩则为原始字符串。

取值范围：

长度为[0-10000000]个字符。

默认取值：

不涉及

请求示例

查询配体文件预览任务。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/preview/{task_id}

响应示例

状态码：200

查询配体文件预览任务成功响应。

{
  "status" : "finished",
  "result" : {
    "count" : 2000,
    "has_more" : true,
    "ligands" : [ {
      "index" : 0,
      "name" : "UNK1",
      "success" : true,
      "smiles" : "CC(=O)N[C@@H](Cc1ccc(CC(=O)O)c(C(=O)O)c1)C(=O)N[C@H]1CCCCN(Cc2ccc(-c3ccccc3)cc2)C1=O",
      "formula" : "C33H35N3O7",
      "is_3d" : false,
      "structure" : {
        "format" : "PDB",
        "compressed" : true,
        "data" : "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"
      },
      "reason" : null
    }, {
      "index" : 1,
      "name" : "UNK2",
      "success" : true,
      "smiles" : "COc1ccc(-c2cc(=O)c3c(O)cc(O[C@@H]4O[C@H](CO[C@@H]5O[C@@H](C)[C@H](O)[C@@H](O)[C@H]5O)[C@@H](O)[C@H](O)[C@H]4O)cc3o2)cc1O",
      "formula" : "C28H32O15",
      "is_3d" : false,
      "structure" : {
        "format" : "PDB",
        "compressed" : true,
        "data" : "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"
      },
      "reason" : null
    } ]
  }
}

状态码

状态码

描述

200

查询配体文件预览任务成功响应。

错误码

请参见错误码。

父主题： 药物通用接口

相关文档