获取SAR文件详情
查询SAR解析任务的状态及结果,全部文件解析完成后返回详情
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
必填 | string | abc123xyz | 任务ID,由 /file/extract 接口返回的 taskId |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | object | - | 响应数据 |
files | array | [
{
"fileId": "abc123",
"status": "SUCCESS",
"fileName": "patent.pdf"
}
] | 文件详情列表 |
items | array | [
{
"unit": "nM",
"value": "10",
"resultId": "result_001",
"indicator": "IC50"
}
] | SAR解析结果列表(仅 status=SUCCESS 时返回) |
unit | string | nM | 单位 |
match | boolean | true | 结构匹配度 |
value | string | 10 | 数值 |
source | object | {
"x": 100,
"y": 200,
"page": 1,
"width": 300,
"height": 50
} | bbox信息 |
target | array | [
"EGFR",
"HER2"
] | 标准化靶点 |
indicator | string | IC50 | 指标 |
result_id | string | result_123456 | 结果ID |
structure | object | {
"mol": "...",
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"inchyKey": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N"
} | 结构式 |
mol | string | CC(=O)Oc1ccccc1C(=O)O
MJ201900
7 7 0 0 0 0 0 0 0 0999 V2000 | MOL格式 |
smiles | string | CC(=O)Oc1ccccc1C(=O)O | SMILES表达式 |
inchy_key | string | BSYNRYMUTXBXSQ-UHFFFAOYSA-N | InChI Key |
other_name | string | Compound A | 其他名称 |
value_source | string | Literature | 活性来源 |
dosing_regimen | object | {
"route": "Oral",
"dosage": "10 mg/kg",
"duration": "7 days",
"frequency": "Once daily"
} | 给药方案 |
route | string | Oral | 给药途径 |
dosage | string | 10 mg/kg | 剂量 |
duration | string | 7 days | 持续时间 |
frequency | string | Once daily | 频次 |
substance_code | object | {
"code": "C001",
"name": "Compound A"
} | 物质代号 |
protein_subtype | string | EGFR-T790M | 蛋白及其亚型 |
experimental_method | string | MTT assay | 实验方法 |
experimental_target | string | EGFR | 实验靶点 |
standardized_target | array | [
{
"targetId": "T001",
"displayNameCn": "表皮生长因子受体",
"displayNameEn": "EGFR"
}
] | 标准化靶点 |
target_id | string | T001 | 靶点ID |
display_name_cn | string | 表皮生长因子受体 | 中文展示名 |
display_name_en | string | EGFR | 英文展示名 |
experimental_purpose | string | Cytotoxicity | 实验目的 |
experimental_subject | string | Cell line | 实验对象 |
total | integer<int32> | 5 | 结果总数(仅 status=SUCCESS 时返回) |
status | string | SUCCESS | 文件状态:PENDING / PROCESSING / SUCCESS / FAILED |
file_id | string | abc123xyz | 文件ID |
file_name | string | patent.pdf | 文件名 |
status | string | PROCESSING | 任务整体状态:PENDING(等待)/ PROCESSING(处理中)/ SUCCESS(成功)/ FAILED(失败)/ NOT_FOUND(不存在) |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect! | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": {
"files": [
{
"items": [
{
"unit": "nM",
"match": true,
"value": 10,
"source": {
"x": 100,
"y": 200,
"page": 1,
"width": 300,
"height": 50
},
"target": [
"EGFR",
"HER2"
],
"indicator": "IC50",
"result_id": "result_123456",
"structure": {
"mol": "CC(=O)Oc1ccccc1C(=O)O\n MJ201900 \n\n 7 7 0 0 0 0 0 0 0 0999 V2000",
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"inchy_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N"
},
"other_name": "Compound A",
"value_source": "Literature",
"dosing_regimen": {
"route": "Oral",
"dosage": "10 mg/kg",
"duration": "7 days",
"frequency": "Once daily"
},
"substance_code": {
"code": "C001",
"name": "Compound A"
},
"protein_subtype": "EGFR-T790M",
"experimental_method": "MTT assay",
"experimental_target": "EGFR",
"standardized_target": [
{
"target_id": "T001",
"display_name_cn": "表皮生长因子受体",
"display_name_en": "EGFR"
}
],
"experimental_purpose": "Cytotoxicity",
"experimental_subject": "Cell line"
}
],
"total": 5,
"status": "SUCCESS",
"file_id": "abc123xyz",
"file_name": "patent.pdf"
}
],
"status": "PROCESSING"
},
"status": true,
"error_code": 0
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常,请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200000 | API整体限流错误! |
67200001 | API整体限流错误! |
67200002 | 当前调用速率过快,超过当前配置限制QPS! |
67200003 | 申请token的key和secret传参不正确或者客户端已被禁用! |
67200004 | 请求的接口无权限请联系我们的支持人员! |
67200005 | 账户余额/调用次数不足! |
67200006 | 客户端超过开通有效期! |
67200007 | 当前调用超过当天配置使用额度! |
67200008 | 请检查query参数中必填的apikey是否传输! |
67200009 | apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token! |
67200012 | 请求不合法! |
67200100 | 当前服务器状态正忙,请求响应超时! |
67200101 | 当前请求的Api不存在请检查请求Path! |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms