[L012]文献引用
可以通过输入paper id或doi 查询某条具体文献的引用数据。
paper_id和doi两个参数必须要有一个,如果两个都存在,会优先使用paper_id。 该接口支持批量请求,上限为100条,请求参数相互之间用英文,隔开。批量请求在进行流量/费用扣减的时候,会根据返回结果的成功条数进行多次扣减。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | 10.1016/j.bpj.2024.07.030 | doi(仅支持传入单个doi) |
| integer<int32> | 1 | 页数 |
| string | 00001b6d-2cfa-411a-ab41-8a05fd675d46,00001756-243f-4738-a288-282987105915 | 文献id |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | array | - | 响应数据 |
doi | string | 10.3390/s20030734 | DOI |
paper_id | string | 1f0f61d1-0d76-3a29-a677-7f0cf7a332f7,00001b6d-2cfa-411a-ab41-8a05fd675d46 | 文献id |
reference_no | integer<int32> | 20 | 参考文献数量 |
np_citation_no | integer<int32> | 2 | 被引证文献数量 |
reference_data | array | Please check the form: LiteratureReference | 参考文献信息 |
paper_id | string | 4590883d-3d89-35ef-b662-cd820dc1427c | 文献id |
sequence | integer<int32> | 1 | 序号 |
citation_text | string | A review of infectious bovine rhinotracheitis, shipping fever pneumonia and viral-bacterial synergism in respiratory disease of cattle.W D Yates.Can J Comp Med.1982 Jul;46(3):225-63. | 引用文章 |
np_citation_data | array | Please check the form: LiteratureNPCitation | 被引证文献信息 |
paper_id | string | 4b656503-a352-4815-93ba-76a7cb967d25 | 文献id |
citation_text | string | A review of infectious bovine rhinotracheitis, shipping fever pneumonia and viral-bacterial synergism in respiratory disease of cattle.W D Yates.Can J Comp Med.1982 Jul;46(3):225-63. | 引用文章 |
patent_citation_no | integer<int32> | 1 | 被引证专利数量 |
patent_citation_data | array | Please check the form: LiteraturePatentCitation | 被引证专利信息 |
pn | string | CN112833870A | 专利号 |
apdt | integer<int32> | 20201230 | 申请日 |
apno | string | CN202011610975.8 | 申请号 |
pbdt | integer<int32> | 20201230 | 公开日 |
title | string | 核磁共振陀螺中抑制碱金属原子极化磁场影响的有效方法 | 标题 |
inventor | array | [
"张燚",
"汪之国",
"李佳佳"
] | 发明人 |
patent_id | string | fd509ad5-7da1-464f-9b32-2858be00f2e9 | 专利ID |
current_assignee | array | [
"中国人民解放军国防科技大学"
] | 当前申请人 |
original_assignee | array | [
"中国人民解放军国防科技大学"
] | 原始申请人 |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect! | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": [
{
"doi": "10.3390/s20030734",
"paper_id": "1f0f61d1-0d76-3a29-a677-7f0cf7a332f7,00001b6d-2cfa-411a-ab41-8a05fd675d46",
"reference_no": 20,
"np_citation_no": 2,
"reference_data": [
{
"paper_id": "4590883d-3d89-35ef-b662-cd820dc1427c",
"sequence": 1,
"citation_text": "A review of infectious bovine rhinotracheitis, shipping fever pneumonia and viral-bacterial synergism in respiratory disease of cattle.W D Yates.Can J Comp Med.1982 Jul;46(3):225-63."
}
],
"np_citation_data": [
{
"paper_id": "4b656503-a352-4815-93ba-76a7cb967d25",
"citation_text": "A review of infectious bovine rhinotracheitis, shipping fever pneumonia and viral-bacterial synergism in respiratory disease of cattle.W D Yates.Can J Comp Med.1982 Jul;46(3):225-63."
}
],
"patent_citation_no": 1,
"patent_citation_data": [
{
"pn": "CN112833870A",
"apdt": 20201230,
"apno": "CN202011610975.8",
"pbdt": 20201230,
"title": "核磁共振陀螺中抑制碱金属原子极化磁场影响的有效方法",
"inventor": [
"张燚",
"汪之国",
"李佳佳"
],
"patent_id": "fd509ad5-7da1-464f-9b32-2858be00f2e9",
"current_assignee": [
"中国人民解放军国防科技大学"
],
"original_assignee": [
"中国人民解放军国防科技大学"
]
}
]
}
],
"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