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

受体信息解析

功能介绍

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

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。

约束限制

不涉及

取值范围

仅支持字母、数字、中划线和下划线,长度为[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

受体信息解析响应。

错误码

请参见错误码

相关文档