
# ADMET属性预测接口(默认+自定义属性)
#### 功能介绍
计算小分子的物化性质，包括默认的吸收(adsorption)、分布(distribution)、代谢(metabolism)、清除(excretion)与毒性(toxicity)，以及用户自定义的属性。
#### URI
POST /v2/{project_id}/admet
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                           |
|:---|:---|:---|:---|
| project_id | 是    | String | 华为云项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-eihealth/eihealth_33_0044.html)中获取。 最小长度：**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。 |
   
表3请求Body参数 
| 参数           | 是否必选 | 参数类型                                                                                               | 描述            |
|:---|:---|:---|:---|
| smiles       | 是    | String                                                                                             | 分子SMILES表达式   |
| custom_props | 否    | Array of [CustomProp] objects | 用户已开启的自定义属性集合 |
   
 表4CustomProp 
| 参数              | 是否必选 | 参数类型                                                                                             | 描述                                                                                                          |
|:---|:---|:---|:---|
| id              | 是    | String                                                                                           | 自定义属性的ID（API侧） 最小长度：**1** 最大长度：**64** |
| prop_definition | 否    | [PropDefinition] object | 属性定义的元信息                                                                                                    |
   
 表5PropDefinition 
| 参数                    | 是否必选 | 参数类型                                                                                     | 描述                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| id                    | 否    | String                                                                                   | 属性业务侧ID 最小长度：**1** 最大长度：**128**                                                                                                                                                                                                   |
| name                  | 否    | String                                                                                   | 属性名称 最小长度：**1** 最大长度：**32**                                                                                                                                                                                                           |
| type                  | 否    | String                                                                                   | 属性类型 枚举值： - **binary**  - **numerical**               |
| description           | 否    | String                                                                                   | 属性具体描述信息 最小长度：**0** 最大长度：**256**                                                                                                                                                                                                 |
| value_range           | 否    | [ValueRange] object | 属性有效值域区间                                                                                                                                                                                                                                                                                                 |
| optimal_range         | 否    | [ValueRange] object | 属性最优值域区间                                                                                                                                                                                                                                                                                                 |
| warning_range         | 否    | [ValueRange] object | 属性欠佳值域区间                                                                                                                                                                                                                                                                                                 |
| style                 | 否    | String                                                                                   | 模型参数呈现类型 枚举值： - **number**  - **probability**   |
| confidential_interval | 否    | Boolean                                                                                  | 模型推理是否呈现置信区间                                                                                                                                                                                                                                                                                             |
   
 表6ValueRange 
| 参数              | 是否必选 | 参数类型    | 描述       |
|:---|:---|:---|:---|
| lower           | 否    | Number  | 值域下限     |
| lower_inclusive | 否    | Boolean | 是否包含值域下限 |
| upper           | 否    | Number  | 值域上限     |
| upper_inclusive | 否    | Boolean | 是否包含值域上限 |
   
#### 响应参数
**状态码： 200**
表7响应Body参数 
| 参数           | 参数类型                                                                                                | 描述                   |
|:---|:---|:---|
| custom_props | Array of [CustomProp] objects | 用户已开启的自定义属性集合        |
| props        | Object                                                                                              | 分子ADMET属性字典(包含自定义属性) |
   
 表8CustomProp 
| 参数              | 参数类型                                                                                              | 描述                                                                                                        |
|:---|:---|:---|
| id              | String                                                                                            | 自定义属性的ID（API侧） 最小长度：**1** 最大长度：**64** |
| prop_definition | [PropDefinition] object | 属性定义的元信息                                                                                                  |
   
 表9PropDefinition 
| 参数                    | 参数类型                                                                                      | 描述                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| id                    | String                                                                                    | 属性业务侧ID 最小长度：**1** 最大长度：**128**                                                                                                                                                                                                       |
| name                  | String                                                                                    | 属性名称 最小长度：**1** 最大长度：**32**                                                                                                                                                                                                        |
| type                  | String                                                                                    | 属性类型 枚举值： - **binary**  - **numerical**          |
| description           | String                                                                                    | 属性具体描述信息 最小长度：**0** 最大长度：**256**                                                                                                                                                                                                    |
| value_range           | [ValueRange] object | 属性有效值域区间                                                                                                                                                                                                                                                                                                  |
| optimal_range         | [ValueRange] object | 属性最优值域区间                                                                                                                                                                                                                                                                                                  |
| warning_range         | [ValueRange] object | 属性欠佳值域区间                                                                                                                                                                                                                                                                                                  |
| style                 | String                                                                                    | 模型参数呈现类型 枚举值： - **number**  - **probability**   |
| confidential_interval | Boolean                                                                                   | 模型推理是否呈现置信区间                                                                                                                                                                                                                                                                                              |
   
 表10ValueRange 
| 参数              | 参数类型    | 描述       |
|:---|:---|:---|
| lower           | Number  | 值域下限     |
| lower_inclusive | Boolean | 是否包含值域下限 |
| upper           | Number  | 值域上限     |
| upper_inclusive | Boolean | 是否包含值域上限 |
   
#### 请求示例
预测一个分子的ADMET属性
```
{
  "smiles" : "c1ccccc1",
  "custom_props" : [ {
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
    "prop_definition" : {
      "id" : "c4c07032d1934671a0dfe3bd10416eea",
      "name" : "custom_prop_name",
      "type" : "numerical",
      "description" : "custom_prop_description"
    }
  } ]
}
```
#### 响应示例
**状态码： 200**
ADMET成功响应
```
{
  "custom_props" : [ {
    "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
    "prop_definition" : {
      "id" : "c4c07032d1934671a0dfe3bd10416eea",
      "name" : "custom_prop_name",
      "type" : "numerical",
      "description" : "custom_prop_description"
    }
  } ],
  "props" : {
    "ab" : "base",
    "acute_toxicity_rule" : 0,
    "alarm_nmr_rule" : 0,
    "ames" : 4.555075065582059E-6,
    "3b2dce64-c244-11ed-acf5-0255ac100017" : 0.85
  }
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | ADMET成功响应     |
| 400 | 分子SMILES输入不合法 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。
