文档首页/AI科学计算服务/API参考/API/小分子药物设计/药物通用接口/受体信息解析 - ParseDrugReceptorInfo
更新时间：2025-12-23 GMT+08:00
查看PDF
分享

受体信息解析 - ParseDrugReceptorInfo

功能介绍

受体信息解析，如果有多个受体蛋白则只处理第一个，如果一个受体蛋白里结合了多个配体，则最多只处理前10个。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/receptor/info

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

eihealth_project_id

是

String

参数解释：

空间ID，您可以从获取空间ID中获取。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

source

是

String

参数解释：

受体数据源。

约束限制：

不涉及

取值范围：

  • EXTRANET：外部网络数据

  • PRIVATE：私有数据

  • PUBLIC：公共数据

  • RAW：源数据

默认取值：

不涉及

url

否

String

参数解释：

文件URL。

约束限制：

当数据源source为外部网络数据时为https地址，为用户私有数据中心时为空间路径，为公共数据场景时为obs地址。

取值范围：

文件URL需以pdb结尾，长度为[1-2000]个字符。

默认取值：

不涉及

format

否

String

参数解释：

文件格式。

约束限制：

当数据源source为RAW时提供。

取值范围：

仅支持PDB。

默认取值：

不涉及

data

否

String

参数解释：

文件原始数据。

约束限制：

当数据源source为RAW时提供。

取值范围：

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

默认取值：

不涉及

add_hydrogen

否

Boolean

参数解释：

是否增加氢原子。

约束限制：

不涉及

取值范围：

  • true：增加氢原子

  • false：不增加氢原子

默认取值：

true

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

residues

Array of ResidueDto objects

参数解释：

受体中的氨基酸残基列表。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

ligands

Array of ReceptorLigandInfoDto objects

参数解释：

受体中的配体列表。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表5 ResidueDto

参数

参数类型

描述

chain

String

参数解释：

氨基酸残基或者配体链的名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

name

String

参数解释：

氨基酸残基或者配体名称。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

id

Long

参数解释：

氨基酸残基或者配体的序列ID。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

表6 ReceptorLigandInfoDto

参数

参数类型

描述

index

Integer

参数解释：

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

约束限制：

不涉及

取值范围：

0-9

默认取值：

不涉及

name

String

参数解释：

配体名称，即配体所在的残基表示。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

success

Boolean

参数解释：

解析是否成功。

约束限制：

不涉及

取值范围：

  • true：成功

  • false：失败

默认取值：

不涉及

smiles

String

参数解释：

分子SMILES表达式。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

formula

String

参数解释：

配体分子的化学式。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

structure

LigandStructureDto object

参数解释：

配体3D结构。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

bounding_box

DrugBoundingBoxDto object

参数解释：

结合口袋，包含口袋中心位置和尺寸大小。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表7 LigandStructureDto

参数

参数类型

描述

format

String

参数解释：

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

compressed

Boolean

参数解释：

是否压缩。

约束限制：

不涉及

取值范围：

  • true：压缩

  • false：不压缩

默认取值：

false

data

String

参数解释：

结构数据。

约束限制：

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

取值范围：

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

默认取值：

不涉及

表8 DrugBoundingBoxDto

参数

参数类型

描述

center

Array of doubles

参数解释：

口袋中心坐标，x、y、z轴的坐标。

约束限制：

数组长度固定为3，数组元素大小取值范围为[-9999999-99999999]。

取值范围：

不涉及

默认取值：

不涉及

size

Array of floats

参数解释：

口袋尺寸大小，x、y、z轴的大小。

约束限制：

数组长度固定为3，数组元素大小取值范围为[2-500]。

取值范围：

不涉及

默认取值：

不涉及

请求示例

受体信息解析，如果有多个受体蛋白则只处理第一个，如果一个受体蛋白里结合了多个配体，则最多只处理前10个。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/receptor/info

{
  "source" : "RAW",
  "url" : "https://files.rcsb.org/download/1TQN.pdb",
  "format" : "PDB",
  "data" : "MODEL1.xxxxxxx.END"
}

响应示例

状态码：200

受体信息解析响应。

{
  "residues" : [ {
    "chain" : "",
    "name" : "BOX",
    "id" : 1
  } ],
  "ligands" : [ ]
}

状态码

状态码

描述

200

受体信息解析响应。

错误码

请参见错误码。

父主题：药物通用接口

相关文档