物质检索

接口说明

物质检索接口提供通过物质各项属性、性质及参数检索相关物质的功能。支持 And 和 Or 逻辑，支持拓展检索。接口返回物质部分信息。

接口地址

POST https://openapi.molaid.com/v1/chem/search

请求参数

名称	类型	必填	说明
pagination	object	是	分页参数
- offset	int64	是	偏移量
- limit	int64	是	获取条数
search	[Object]	是	检索条件
- logic_symbol	enum	是	条件逻辑
- filter	object	是	条件内容
- - field	enum	是	检索字段
- - value	object	是	检索值（根据检索字段决定传参字段，对应字段为必填）
- - - str	string	否	字符串检索值
- - - multi_str	[string]	否	字符串数组检索值
- - - range	Object	否	数值范围检索值（不能同时为空）
- - - - min	string	否	最小值（空字符串表示不限制）
- - - - max	string	否	最大值（空字符串表示不限制）
- - - structure	Object	否	结构式检索值
- - - - mol	string	是	mol码
- - - - mode	enum	是	结构式检索模式
- - - group_judge	[Object]	否	特征基团检索值
- - - - group	string	是	特征基团
- - - - num	number(int)	是	数量
extend	bool	是	是否拓展检索

返回参数

名称	类型	说明
total	number(int)	总数
list	[object]	物质信息
- pedia_id	string	物质ID
- title	string	标题
- inchikey	string	InChIKey
- molecular_formula	string	分子式
- molecular_weight	number(float)	分子量
- cas	[string]	CAS号
- name_cn	[string]	中文名称
- name_en	[string]	英文名称

请求示例

{
  "pagination": {
    "offset": 0,
    "limit": 10
  },
  "search": [
    {
      "logic_symbol": "And",
      "filter": {
        "field": "code_inchi_key",
        "value": {
          "str": "UHOVQNZJYSORNB-UHFFFAOYSA-N"
        }
      }
    },
    {
      "logic_symbol": "Or",
      "filter": {
        "field": "attr_group_judge",
        "value": {
          "group_judge": [
            {
              "group": "苯环",
              "num": 1
            }
          ]
        }
      }
    }
  ],
  "extend": true
}

返回示例

正常返回

{
  "code": 200,
  "data": {
    "total": 1,
    "list": [
      {
        "pedia_id": "fvYH86M4hw28QRcUCHJhpJYSnYswWZp5",
        "title": "苯 | benzene",
        "inchikey": "UHOVQNZJYSORNB-UHFFFAOYSA-N",
        "molecular_formula": "C<sub>6</sub>H<sub>6</sub>",
        "molecular_weight": 78.1136,
        "cas": [
          "71-43-2"
        ],
        "name_cn": [
          "苯",
          "1,3,5-环己三烯",
          "环己-1,3,5-三烯",
          "安息油",
          "苯查儿",
          "纯苯",
          "精苯",
          "净苯",
          "困净苯",
          "溶剂苯"
        ],
        "name_en": [
          "benzene"
        ]
      }
    ]
  },
  "reason": "",
  "message": "",
  "metadata": {
    "request_id": "d8f3c006d858acf3c6d3e05438bfca4c"
  }
}

错误返回

{
  "code": 422,
  "reason": "PEDIA_CONDITION_ERROR",
  "message": "condition error:attr_group_judge group_judge empty",
  "metadata": {
    "request_id": "d8f3c006d858acf3c6d3e05438bfca4c"
  }
}

错误码

全局错误码详见错误码

http status	错误码	错误说明
422	PEDIA_CONDITION_ERROR	检索条件错误。请根据错误message判断错误具体原因
422	STRUCTURE_ERROR	结构式错误。请检查结构式mol码是否正确

枚举值

条件逻辑

枚举值	说明
And	与
Or	或

检索字段

枚举值	传参字段	说明
attr_mark_name	multi_str	相关结构异构体
attr_group_judge	group_judge	特征基团
attr_structure	structure	结构式
exp_melting_p	range	实验性质-熔点范围
exp_boiling_p	range	实验性质-沸点范围
exp_density	range	实验性质-密度范围
exp_pka	range	实验性质-酸度系数/解离常数范围
exp_flash_p	range	实验性质-闪点范围
exp_refractive_index	range	实验性质-折光率范围
exp_autoignition_temp	range	实验性质-自燃温度范围
exp_vapor_pressure	range	实验性质-蒸汽压力范围
exp_vapor_density	range	实验性质-蒸汽密度范围
comp_log_p	range	计算性质-辛醇/水分配系数范围
comp_heavy_atom_c	range	计算性质-重原子数范围
comp_rotatable_bond_c	range	计算性质-可旋转键数范围
comp_number_of_rings	range	计算性质-环数范围
comp_fsp3	range	计算性质-Fsp3范围
comp_polar_surface_area	range	计算性质-拓扑面积范围
comp_hydrogen_bond_acceptor_c	range	计算性质-氢受体数范围
comp_hydrogen_bond_donor_c	range	计算性质-氢给体数范围
attr_pedia_name	str	化合物名称
attr_molecular_formula	str	分子式
code_cas	str	CAS号
code_inchi_key	str	InChIKey
code_inchi	str	InChI
code_mdl	str	MDL
code_einecs	str	EINECS
code_beilstein	str	Beilstein
code_merck_id	str	Merck索引

结构式检索模式

枚举值	说明
default	默认检索（精确）
substructure	子结构检索
similar	相似度检索

酮羰基；氟代；钠；铜；锂；钙；β-丙内酰胺；四氢呋喃；酚羟基；烯烃；镁；吡咯；菲；锡；异喹啉；钌；咔唑；银；硼；环庚烷；氨基；嘌呤；β-丙内酯；铝；氧杂卓；磷；羧基；硝基；钡；蒽；钯；氰基；砷；噻唑；锰；吩噻嗪；钛；钼；吡喃；蹄；吡嗪；硒；金；铑；镍；醇羟基；吡啶；氮杂环丙烷；哒嗪；吲哚；喹啉；醚；钾；溴代；环丙烷；蒽醌；噁唑；嘧啶；锌；吡唑；环戊烷；酸酐；呋喃；二噁烷；环己烷；哌嗪；吩嗪；酯基；环氧乙烷；噻吩；四氢吡咯；蝶啶；萘；酰胺；铁；钴；铂；醛羰基；硅；汞；炔烃；苯环；氯代；环丁烷；顺丁烯二酸酐；铬；碘代；硫；咪唑

注意事项

单页最多获取20条物质数据；分页获取最多1000条物质数据。
search 字段为筛选条件数组。检索逻辑参考：下方请求的检索逻辑为((InChIKey条件 AND 熔点范围条件) OR 特征基团条件)) AND 结构式条件，以此类推。

{
  "pagination": {
    "offset": 0,
    "limit": 10
  },
  "search": [
    {
      // InChIKey条件
      "logic_symbol": "Or",
      "filter": {
        "field": "code_inchi_key",
        "value": {
          "str": ""
        }
      }
    },
    {
      // 熔点范围条件
      "logic_symbol": "And",
      "filter": {
        "field": "exp_melting_p",
        "value": {
          "range": {
            "min": "",
            "max": ""
          }
        }
      }
    },
    {
      // 特征基团条件
      "logic_symbol": "Or",
      "filter": {
        "field": "attr_group_judge",
        "value": {
          "group_judge": [
            {
              "group": "",
              "num": 1
            }
          ]
        }
      }
    },
    {
      // 结构式条件
      "logic_symbol": "And",
      "filter": {
        "field": "attr_structure",
        "value": {
          "structure": {
            "mol": "",
            "mode": "default"
          }
        }
      }
    }
  ],
  "extend": true
}