反应检索

接口说明

本接口提供基于物质ID、物质SMILES码以及反应smiles码进行反应检索的功能，支持按物质角色筛选反应数据。返回包含反应SMILES、文献信息及反应条件等详细信息。

计费方式

按照数据条数收费，调用成功，单条数据收费0.25元。

接口地址

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

请求参数

名称	类型	必填	说明
pagination	object	是	分页参数
- offset	uint32	是	偏移量
pedia_search	object	否	通过物质检索；与通过反应检索二选一
- pedia_id	string	否	物质ID；与物质SMILES码二选一
- smiles	string	否	物质SMILES；与物质ID二选一
- role	[enum]	否	物质角色
synth_search	object	否	通过反应检索；与通过物质检索二选一
- rxn	string	是	反应SMILES码

返回参数

名称	类型	说明
total	int32	总数
list	[object]	反应列表
- rxn	string	反应SMILES
- detail	[object]	反应详情
- - doi	string	DOI标识
- - title	string	文献标题
- - condition	[string]	简要反应描述
- - condition_info	[object]	反应描述
- - - yield	[object]	产率信息
- - - - smiles	string	物质SMILES
- - - - value	string	产率值
- - - solvent	[string]	溶剂
- - - reagent	[string]	试剂
- - - catalyst	[string]	催化剂
- - - other	[string]	其他
- - - duration	string	时间（小时）
- - - temperature	string	温度
- - - pressure	string	压强（帕）

请求示例

通过物质检索

{
  "pagination": {
    "offset": 0
  },
  "pedia_search": {
    "pedia_id": "",
    "smiles": "C1=CC=CC=C1",
    "role": [
      "role_reactant"
    ]
  }
}

通过反应检索

{
    "pagination": {
        "offset": 0
    },
    "synth_search": {
        "rxn": "C1=CC=CC=C1.CC(=O)Cl>>CC(=O)C1=CC=CC=C1"
    }
}

返回示例

正常返回

{
  "code": 200,
  "data": {
    "total": 62881,
    "list": [
      {
        "rxn": "C1=CC=CC=C1.CC(=O)Cl>>CC(=O)C1=CC=CC=C1",
        "detail": [
          {
            "doi": "doi",
            "title": "Devi, Nirada; Ganguly, Mausumi, Indian Journal of Chemistry - Section B Organic and Medicinal Chemistry, 2008, vol. 47, # 1, p. 153 - 154",
            "condition": [],
            "condition_info": [
              {
                "yield": [
                  {
                    "smiles": "CC(=O)C1=CC=CC=C1",
                    "value": "68%"
                  }
                ],
                "solvent": [],
                "reagent": [
                  "montmorillonite K<sub>10</sub> clay (washed with aq. HCl)"
                ],
                "catalyst": [],
                "other": [],
                "duration": "0.03 h",
                "temperature": "",
                "pressure": ""
              }
            ]
          }
        ]
      },
      {
        "rxn": "C1CC(=O)OC1.C1=CC=CC=C1>>C1=CC=C(C=C1)CCCC(=O)[O-].[Na+]",
        "detail": [
          {
            "doi": "doi",
            "title": "[EN] SYNTHESIS OF 4-PHENYLBUTYRIC ACID<br/>[FR] SYNTHESE D'ACIDE 4-PHENYLBUTYRIQUE",
            "condition": [
              "cmm31700, AlCl₃, 50 ℃",
              "cmm31701, 50 to 60 ℃",
              "Ice, 5% NaOH, <35 ℃"
            ],
            "condition_info": []
          }
        ]
      }
    ]
  },
  "reason": "",
  "message": "",
  "metadata": {
    "request_id": "d8f3c006d858acf3c6d3e05438bfca4c"
  }
}

错误返回

{
  "code": 422,
  "reason": "SYNTH_CONDITION_ERROR",
  "message": "condition error:pedia_id empty",
  "metadata": {
    "request_id": "d8f3c006d858acf3c6d3e05438bfca4c"
  }
}

错误码

全局错误码详见错误码

http status	错误码	错误说明
422	SYNTH_CONDITION_ERROR	检索条件错误。请根据错误message判断错误具体原因

枚举值

物质角色枚举

枚举值	说明
role_reactant	反应物
role_product	产物
role_solvent	溶剂
role_reagent	试剂
role_catalyst	催化剂

注意事项

单页最多获取1条数据；分页获取最多1000条数据。
通过物质检索必须至少提供pedia_id或smiles中的一个参数;当同时提供pedia_id和smiles时，以pedia_id为优先条件。
通过物质检索与通过反应检索必须提供一个条件，以通过物质检索为优先条件。
当反应描述 condition_info 为空时，会返回简要反应描述 condition。