文档首页/ AI科学计算服务/ API参考/ API/ 小分子药物设计/ 药物通用接口/ 查询配体文件预览任务
更新时间：2025-09-25 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

参数解释：

任务状态。

约束限制：

不涉及

取值范围：

  • WAITING：等待中

  • RUNNING：运行中

  • FINISHED：完成

  • CANCELLED：取消

  • ABNORMAL：异常

  • FAILED：失败

默认取值：

不涉及

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" : "H4sIABt7PGUC/41ZS5IbNwzd+xS6gLsI8L9MdVzVi0Szce5/leABmDHlphJMlakSqX4N4vsAXz9+/vHz74f80eNxyr9/nn89/Cv+vtcj5yqf+eCU9HPgkw6sSdevv/Px+HZ9AbJs8B2wHHkW+eQj8TDAkkOA8qsP2gHSlPd8pyP3qd9Hq28AP14ARYznBlAkoqaAPSeVtJV3V36+AMprz3wH5GMMAKajMen30kboyvLUWXYS1i7b8myvwwE5BNhlo+502EpXwJlJr17SDAHK68+2tTINfD9yIb06Ucxt5LVn3/phYgUswyQdI6RDvPYcOwmHAtExYZQHH1x7CFB+/cFbo9RkgLUoYEk94ockYB95d+VG3SRDpDzyQSOFAAXsnHfAdjSVjATQdFh7yChUkBzSDbAffVS38tTP2kOxTIgUUeQGcFaVjOHQcvXGMQnFBz82kTIsQuTZ0pLqsJYW0qEo6GMTKf1IuLI4dOdpEgaNgkgRU9+NMqEzODTeCeAcc2xEipj67jZzWHJo3WK5U8go0PQppr6nrwQJRbLRpgLSiAEiUtouH5bELtlQ4FxDGZvlqecm9CRtVUuwqVcFTsg6/5+xGZEizngHJDbJKJHqkmIJljVS2u+ACDWkKyRWdn8soQTLGin9BoiQa2acMtwfQ5HCqCmi9t8B+ag5q4TM5jYcK/RIJac44x2Q2PyQHLi3mNvIfZ73fChPjm5Zhgp7pOSQlREpnDYSDugQCTZPq8+ZIhKCFpx8S18PoSK5qYR9mpUThWIZrz2Zd4DDE2vzcjpDbpOVfd2Sw0PKaLcSQNlqS0oho0DTJ9+Sw6OJ29hVJ3ttKbErI1K4bgBLNx0SMjZCMNcQICKF2+bKPI051GmAvZQQICKF76GHqle8pphRxohJiEjhe+gNydhGRQgZG+4TY1/Q/Mm30KPkQIgQs3Km2JURKTm9AxTdKS8EFUkhQBDnM9P2yl5LlH1lM1IAEJGSeWOUkZxjKyVBXQ75IVLJmfMmY49ixkjTyJKGYgAQfcqdwaIeN3PsOc1t0lujvFQ9eOv1pjUrSjw7YlgYbe/v0tf1AigKungHmJT9Z6PE8plyCwHKr668I5wZ2kADVMj7lhoCFP1dZUfaNaEKIA+rKeNtW/EKKE9ddUdFlFPDbWpWCfPb0HsFlF9dW24z2KxbK+v3nENGQe9w9e2V2WJ5QisiYSk9BChPXWPXp7An2KqkHQk2JqHc55o7wEJeRrWtEB2+ZbCvgBmOvW0rtJOC7qwLSJVDgBoptOsCihmFp109lZCVQUuvDWkf0pcY6+JBVqd7CQEiUjakfcgz1vg0HbMgOcSujEjZkPYmHZRZN1cbYrzvAl4BESlbSty75cFWfTpCMT9EpNwpMdoJ8Hk82+zqc4aMAlpw3SkxmIKHHDXrqPoIpa+GSNlQYnGXbkXqk0HwDEUKeoVrQ4lFZ5+JlaeX05BRcJ9rw2BRU2yYxsU6qlpjV0akbBhs9hIgknp9njOUsZvWFN4AaiePQp+sb84zlLFRK68Ng2Wf14juUJfRTHIoUhoiZcNgxarZ/C8Vz9gzZhREyobBikSoy9Blt44+1VA+RMBeGwYLdzEa17Ilh/cDyRdATHeuDYNFlavuj5a531ORV0BEyobBChUZHsPdRlVpxCREpNwZrNA5HQloUvBxS41JiEi5M1h0AWAMuLKnr0EhoyCvXxsGO+UZ76A++5UUCj0woOvOYAlEM3mWGdY/t1A+7Mq+8jtAbXiazb5i7Atee+WyJe3VZg5khX6mUAmAT1x51+uNacZgzdhCnvJ/Xfn8eP44f34hsJNjJbRCQpdz9v8w8KUsR8Un9UIyl93q43adggldXI6aD86V8wlPW466j8BtobkcDR9mCw9bdqdPpHVGK8uvI9slnwfLshyRsq9lI/tQ9kGLoLZRnVgJGVqOqs9Ida4py3LUlOcsG8OHi7bURa22sTysyrLxuS6LjFrbWQVZZNQNHRQg1wo3WI6Kj7u0wEtRXo6qD660sko1XI6aj6C0pEkZWo66D5O0lkj+X46Gj4VEjGV3+mxHU7uk419Hupvpa1leYxus6XbZZR+a2NKX29iuVohFt7ZRP5e+yGUby6V1yKSdvS5lBe8+F5DEtewOb+5t6av409t0ySO/dnVD+19d+qI721hsqpZEnyfLtx/PP7/9C0SLdzFVHAAA"
      },
      "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

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

错误码

请参见错误码。

父主题： 药物通用接口

相关文档