[B075] 化合物合成路线

post
https://connect.zhihuiya.com/synapse/chemical/reaction/route
在体验中心中试用

根据化合物 InChI Key 查询相关专利反应路线,返回按专利号分组的反应物、产物及其 SMILES 信息。

inchiKey 为必填参数;type 支持 reactant、product,用于限定该化合物在反应中的位置;pn 支持按专利号精确过滤;分页使用 offset 和 limit,limit 最大 100,offset + limit 不超过 10000。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
inchi_key
必填
stringFDLYAMZZIXQODN-UHFFFAOYSA-N
化合物 InChI Key,必填
limit
integer<int32>20
返回条数,默认 20。limit 最大 100,offset + limit 不超过 10000
offset
integer<int32>-
偏移量,默认 0
pn
stringUS8247416
专利号,支持精确过滤;不传则不限定专利号
type
必填
stringproduct
化合物在反应中的位置,必填,支持 reactant、product

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object-
响应数据
limit
integer<int32>20
返回条数
total
integer<int64>100
过滤后的反应总数
offset
integer<int32>-
偏移量
results
arrayPlease check the form:SmilesReactionWithPn
反应数据,按专利号列表分组
pns
array[ "US123A" ]
专利号列表,同一组反应共享该专利号列表
smiles_reactions
arrayPlease check the form:ReactionItem
反应列表,包含反应物和产物
products
arrayPlease check the form:ReactantItem
产物列表
smiles
stringCC(=O)Oc1ccccc1C(=O)O
化合物 SMILES
inchi_key
stringBSYNRYMUTXBXSQ-UHFFFAOYSA-N
化合物 InChI Key
amount_units
arrayPlease check the form:AmountUnit
用量及单位
unit
stringmmol
单位
value
string1
数值
compound_name
stringAspirin
化合物名称
reactants
arrayPlease check the form:ReactantItem
反应物列表
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect!
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON
{
  "data": {
    "limit": 20,
    "total": 100,
    "offset": 0,
    "results": [
      {
        "pns": [
          "US123A"
        ],
        "smiles_reactions": [
          {
            "products": [
              {
                "smiles": "CC(=O)Oc1ccccc1C(=O)O",
                "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
                "amount_units": [
                  {
                    "unit": "mmol",
                    "value": 1
                  }
                ],
                "compound_name": "Aspirin"
              }
            ],
            "reactants": [
              {
                "smiles": "CC(=O)Oc1ccccc1C(=O)O",
                "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
                "amount_units": [
                  {
                    "unit": "mmol",
                    "value": 1
                  }
                ],
                "compound_name": "Aspirin"
              }
            ]
          }
        ]
      }
    ]
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常,请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误!
67200002当前调用速率过快,超过当前配置限制QPS!
67200003申请token的key和secret传参不正确或者客户端已被禁用!
67200004请求的接口无权限请联系我们的支持人员!
67200005账户余额/调用次数不足!
67200006客户端超过开通有效期!
67200007当前调用超过当天配置使用额度!
67200008请检查query参数中必填的apikey是否传输!
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token!
67200012请求不合法!
67200100当前服务器状态正忙,请求响应超时!
67200101当前请求的Api不存在请检查请求Path!

HTTP 状态码

状态码描述
0请求成功
201Created
401Unauthorized
403Forbidden
404Not Found

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms