| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
query |
string | 选填 | - | 检索词(英文题名/关键词/自然语言问题),action=search 必填,与 work_id 二选一 |
work_id |
string | 选填 | - | 文献标识(OpenAlex ID 或 DOI),action=detail 必填 |
action |
string | 选填 | search |
操作类型:search(关键词检索,默认)/ detail(按标识查单篇) |
source |
string | 选填 | openalex |
数据源,首期仅 openalex(默认) |
year_from |
int | 选填 | - | 发表起始年 |
year_to |
int | 选填 | - | 发表截止年 |
only_oa |
boolean | 选填 | false |
仅开放获取,默认 false |
work_type |
string | 选填 | - | 文献类型,如 article/thesis/preprint/review |
country |
string | 选填 | - | 机构所属国家码,如 US/CN |
min_citations |
int | 选填 | - | 最低被引次数 |
sort |
string | 选填 | relevance |
排序:relevance(默认)/ publication_date / cited_by_count |
limit |
int | 选填 | 10 |
返回条数,默认 10,上限 20 |
| 字段名 | 类型 | 说明 |
|---|---|---|
code | int | 状态码,0=成功 |
desc | string | 状态描述 |
data− |
object | 业务数据(成功时返回) |
source |
string | 数据源回显 |
action |
string | 操作类型回显 |
query |
string | 检索词回显(action=search) |
total |
int | 实际返回条数 |
list− |
array | 文献数组 |
work_id |
string | 文献标识(OpenAlex ID) |
title |
string | 题名 |
author |
array | 作者列表,元素含 name |
doi |
string | DOI(可为空) |
publication_date |
string | 发表年份 |
cited_by_count |
int | 被引次数 |
is_oa |
boolean | 是否开放获取 |
oa_url |
string | 开放获取链接(仅链接,不含全文) |
topic |
string | 主题/学科分类 |
source_url |
string | 原始记录链接,供人工核对 |
request_id | string | 请求追踪ID |
{
"code": 0,
"desc": "success",
"data": { ... },
"request_id": "abc123..."
}
{
"code": 999,
"desc": "错误描述",
"request_id": "abc123..."
}
© 网程科技(林州网程科技有限公司) | 豫ICP备2025120409号-2 | 豫B2-20230220 | 豫公网安备 41058102000262号