文档首页/ 医疗智能体/ API参考/ API（盘古辅助制药平台）/ 药物通用接口/ 受体信息解析
更新时间：2024-05-09 GMT+08:00
查看PDF
分享

受体信息解析

功能介绍

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

受体信息解析响应。

错误码

请参见错误码。

父主题： 药物通用接口

相关文档