更新时间:2024-05-09 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

受体的数据源:外部网络数据(如RCSB在线数据库)、用户私有数据中心、承载租户公共数据(含样例/公共库)。

枚举值:

  • EXTRANET
  • PRIVATE
  • PUBLIC
  • RAW

url

String

文件URL,当数据源为外部网络数据时为https地址;用户私有数据中心为项目路径、公共数据场景为obs地址。

最小长度:1

最大长度:2000

format

String

文件格式,仅支持PDB,仅数据源为RAW时提供。

最小长度:1

最大长度:6

data

String

文件原始数据,仅数据源为RAW时提供。

最小长度:0

最大长度:10000000

add_hydrogen

Boolean

增加氢原子。

缺省值:true

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

residues

Array of ResidueDto objects

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

ligands

Array of ReceptorLigandInfoDto objects

受体中的配体列表。

数组长度:0 - 10

表5 ResidueDto

参数

参数类型

描述

chain

String

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

name

String

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

最小长度:1

最大长度:10

id

Long

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

最小长度:1

最大长度:99999

表6 ReceptorLigandInfoDto

参数

参数类型

描述

index

Integer

配体索引(从0起编号)。

最小值:0

最大值:9

name

String

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

最小长度:1

最大长度:128

success

Boolean

解析是否成功。

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

是否压缩。

缺省值:false

data

String

结构数据,如压缩则需要解码、解压处理(ASCII Encode -> Base64 Decode -> GZip Inflate -> UTF-8 Decode)以得到原始字符串;如未压缩则为原始字符串。

最小长度:0

最大长度:10000000

表8 DrugBoundingBoxDto

参数

参数类型

描述

center

Array of floats

口袋中心坐标;x, y, z轴的坐标。

最小值:-9999999

最大值:99999999

数组长度:3 - 3

size

Array of floats

口袋尺寸大小;x, y, z轴的大小。

最小值:2

最大值:500

数组长度:3 - 3

请求示例

受体信息解析,如果有多个受体蛋白则只处理第一个,如果一个受体蛋白里结合了多个配体,则最多只处理前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

受体信息解析响应。

错误码

请参见错误码

相关文档