# 受体信息解析 #### 功能介绍 受体信息解析，如果有多个受体蛋白则只处理第一个，如果一个受体蛋白里结合了多个配体，则最多只处理前10个。 #### URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/receptor/info 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-eihealth/eihealth_33_0044.html)中获取。 最小长度：**1** 最大长度：**128** | | eihealth_project_id | 是 | String | 平台项目ID。 最小长度：**1** 最大长度：**128** | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-eihealth/eihealth_33_0010.html)接口响应消息头中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** | 表5ResidueDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | chain | String | 氨基酸残基或者配体链的名称。 | | name | String | 氨基酸残基或者配体名称。 最小长度：**1** 最大长度：**10** | | id | Long | 氨基酸残基或者配体的序列ID。 最小长度：**1** 最大长度：**99999** | 表6ReceptorLigandInfoDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 结合口袋，包含口袋中心位置和尺寸大小。 | 表7LigandStructureDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | format | String | 配体格式，即文件后缀名。 最小长度：**1** 最大长度：**5** | | compressed | Boolean | 是否压缩。 缺省值：**false** | | data | String | 结构数据，如压缩则需要解码、解压处理（ASCII Encode -\> Base64 Decode -\> GZip Inflate -\> UTF-8 Decode）以得到原始字符串；如未压缩则为原始字符串。 最小长度：**0** 最大长度：**10000000** | 表8DrugBoundingBoxDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 受体信息解析响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。