计算配体间的3D结构差异 - CheckDrugLigandDifference

功能介绍

计算配体间的3D结构差异。

授权信息

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

URI

POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/diff3d

表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参数
参数	是否必选	参数类型	描述
method	是	String	参数解释：差异计算方法。约束限制：不涉及取值范围： RMSD EMD 默认取值：不涉及
file	是	DrugFile object	参数解释：配体文件。约束限制：不涉及取值范围：不涉及默认取值：不涉及
ref_file	是	DrugFile object	参数解释：参考的配体文件。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表4 DrugFile
参数	是否必选	参数类型	描述
source	是	String	参数解释：受体数据源。约束限制：不涉及取值范围： EXTRANET：外部网络数据 PRIVATE：私有数据 PUBLIC：公共数据 RAW：源数据默认取值：不涉及
url	否	String	参数解释：文件URL。约束限制：当数据源source为外部网络数据时为https地址，为用户私有数据中心时为空间路径，为公共数据场景时为obs地址取值范围：文件仅URL仅支持以.pdb、.mol2、.sdf、.smi为结尾，长度为[1-2000]个字符。默认取值：不涉及
format	否	String	参数解释：文件格式。约束限制：当数据源source为RAW时提供。取值范围： PDB：PDB文件 SDF：SDF文件 MOL2：MOL2文件 SMI：SMI文件默认取值：不涉及
data	否	String	参数解释：文件原始数据。约束限制：当数据源source为RAW时提供。取值范围：长度为[0-10000000]个字符。默认取值：不涉及

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
result	Float	参数解释：差异值。约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求示例

计算配体间的3D结构差异，计算方法为RMSD。

https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/diff3d

{
  "method" : "RMSD",
  "file" : {
    "source" : "PRIVATE",
    "url" : "obs://bucket/path/to/file"
  },
  "ref_file" : {
    "source" : "RAW",
    "format" : "SDF",
    "data" : "xxxxxxx"
  }
}