[B001]化学结构式检索的接口地址是什么？

[B001]化学结构式检索的接口为 POST https://connect.zhihuiya.com/chemical-openapi/compound。

在哪里可以找到 [B001]化学结构式检索的 OpenAPI schema？

OpenAPI schema 位于 /openapi.json#/paths/~1chemical-openapi~1compound/post，也可在 /openapi.json 浏览完整规范。

[B001]化学结构式检索

Q: [B001]化学结构式检索 的接口地址是什么？

[B001]化学结构式检索 的接口为 POST https://connect.zhihuiya.com/chemical-openapi/compound。

Q: [B001]化学结构式检索 可以返回哪些数据？

[B001]化学结构式检索：通过输入关键信息（结构名称、分子式、InChIKey、SMILES、检索类型）检索化学结构，返回结构数量，结构ID，InchiKey， 相似度，各结构相关专利数量和文献数量。。完整响应结构请参见本页的响应结构与成功响应示例。

post

https://connect.zhihuiya.com/chemical-openapi/compound

在体验中心中试用

通过输入关键信息（结构名称、分子式、InChIKey、SMILES、检索类型）检索化学结构，返回结构数量，结构ID，InchiKey，相似度，各结构相关专利数量和文献数量。

通用名称，分子式，inchi，smiles最多只能选择一个。当inchi或smiles选择的时候，结构检索类型必填。

请求参数

此 API 接口支持的参数列表

名称	类型	示例	描述
`name`	`string`	`Aspirin`	结构通用名称
`formula`	`string`	`C9H8O4`	结构分子式
`inchi`	`string`	`InChI=1S/C9H8O4/c1-6(10)13-8-5-3-2-4-7(8)9(11)12/h2-5H,1H3,(H,11,12)`	结构Inchi
`smiles`	`string`	`CC(=O)OC1=CC=CC=C1C(O)=O`	结构Smiles
`search_type`	`string`	`EXT`	结构检索类型，默认值为EXT。单选，可选项为EXT，SIM，SUB，分别为精确检索，相似检索，子结构搜索。仅支持inchi，smiles作为输入。
`sim_threshold`	`number<float>`	`0.5`	相似检索最小阈值，仅对SIM检索类型生效，默认0.5。
`include_stereo`	`boolean`	`true`	是否包含立体异构体，仅对EXT，SUB检索类型生效，默认为true。
`include_tautomer`	`boolean`	`true`	是否包含互变异构体，仅对EXT，SUB检索类型生效，默认为true。
`include_charge`	`boolean`	`true`	是否包含电荷差异，仅对EXT，SUB检索类型生效，默认为true。
`include_isotope`	`boolean`	`true`	是否包含同位素差异，仅对EXT，SUB检索类型生效，默认为true。
`include_radical`	`boolean`	`true`	是否包含自由基差异，仅对EXT，SUB检索类型生效，默认为true。
`page` 必填	`integer<int32>`	`1`	起始页位置。第几页，从1开始计数。
`rows` 必填	`integer<int32>`	`10`	当页数量。当前页包含的结果数量，不超过100。

请求示例

该 API 接口的请求体示例

JSON

{
  "name": "Aspirin",
  "page": 1,
  "rows": 10,
  "inchi": "InChI=1S/C9H8O4/c1-6(10)13-8-5-3-2-4-7(8)9(11)12/h2-5H,1H3,(H,11,12)",
  "smiles": "CC(=O)OC1=CC=CC=C1C(O)=O",
  "formula": "C9H8O4",
  "search_type": "EXT",
  "sim_threshold": 0.5,
  "include_charge": true,
  "include_stereo": true,
  "include_isotope": true,
  "include_radical": true,
  "include_tautomer": true
}

响应结构

API 响应数据的结构说明

字段名	类型	示例	描述
`data`	`object`	-	响应数据
`total`	`integer<int64>`	`100`	命中结构数量
`results`	`array`	`Please check the form: OpenCompoundItem`	命中结构记录
`inchi_key`	`string`	`BSYNRYMUTXBXSQ-UHFFFAOYSA-N`	InchiKey
`similarity`	`number<float>`	`0.98`	相似度。结构相似度运用Tanimoto结构相似度算法仅相似检索会返回该值
`paper_count`	`integer<int32>`	`20`	关联的文献数量
`patent_count`	`integer<int32>`	`20`	关联的专利数量
`status` 必填	`boolean`	`false`	状态
`error_msg`	`string`	`The request parameter format is incorrect！`	错误信息
`error_code` 必填	`integer`	`0`	错误代码

成功响应示例

成功调用 API 的响应示例

JSON

{
  "data": {
    "total": 100,
    "results": [
      {
        "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
        "similarity": 0.98,
        "paper_count": 20,
        "patent_count": 20
      }
    ]
  },
  "status": true,
  "error_code": 0
}

错误码

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

业务错误码

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

平台错误码

错误码	描述
`67200001`	API整体限流错误!
`67200002`	用户调用请求限流限制错误!
`67200003`	申请token的key和secret不正确或者状态错误!
`67200004`	无权限或该接口的套餐已超过系统设置的上限!
`67200005`	账户余额不足，调用失败!
`67200006`	客户端已过期，调用失败!
`67200007`	超过调用额度，调用失败!

HTTP 状态码

状态码	描述
`0`	请求成功
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found
`50400001`	请求参数异常。
`50404002`	未检索到相关数据。

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms