让文献线索，
连接你的研究工具。

01 / OVERVIEW

题录、摘要与解读，按需读取。

列表返回题录与中英文摘要；单篇详情返回已有公共解读，以及已整理的逐理论、假设和研究深读。接口读取现有内容，不会调用 AI 临时生成。已排除条目和个人上传语料（UPLOAD）不会出现在结果中；检索结果不代表期刊的完整权威目录。

访问方式

访问方式以上方服务配置卡为准；当前尚未确认是否需要 API 密钥。

Authorization: Bearer YOUR_API_KEY

配置、健康检查和 OpenAPI 描述始终公开。

02 / QUICKSTART

从一次小查询开始。

先查询题录与摘要，再按 ID 读取完整解读。以下示例按当前服务配置使用鉴权；密钥模式需替换 YOUR_API_KEY。

curl --get '__API_BASE__/papers' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'q=leadership' \
  --data-urlencode 'limit=2'

import json
import os
from urllib.parse import urlencode
from urllib.request import Request, urlopen

base = "__API_BASE__"
key = os.environ.get("GAGA_API_KEY", "YOUR_API_KEY")
query = urlencode({"q": "leadership", "limit": 2})
request = Request(
    f"{base}/papers?{query}",
    headers={"Authorization": f"Bearer {key}"},
)
with urlopen(request, timeout=20) as response:
    data = json.load(response)
print(json.dumps(data, ensure_ascii=False, indent=2))

const query = new URLSearchParams({ q: "leadership", limit: "2" });
const response = await fetch(`__API_BASE__/papers?${query}`, {
  method: "GET",
  credentials: "omit",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || `HTTP ${response.status}`);
console.log(data);

按 ID 获取单篇完整解读

单篇接口默认返回现有全部公共解读，无需另加参数。可试用 68935（实证研究深读）、131（理论论文）或 89391（部分覆盖）；以实际响应中的内容与覆盖状态为准。

curl '__API_BASE__/papers/68935' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

import json
import os
from urllib.request import Request, urlopen

base = "__API_BASE__"
key = os.environ.get("GAGA_API_KEY", "YOUR_API_KEY")
paper_id = 68935
request = Request(
    f"{base}/papers/{paper_id}",
    headers={"Authorization": f"Bearer {key}"},
)
with urlopen(request, timeout=20) as response:
    item = json.load(response)["item"]
print(json.dumps(item, ensure_ascii=False, indent=2))

# deep_analysis may be null; missing content is not generated on request.
deep = item.get("deep_analysis") or {}
for study in deep.get("studies", []):
    print(json.dumps(study, ensure_ascii=False, indent=2))

03 / REFERENCE

五个入口，一个稳定的版本前缀。

列表查询参数

所有参数均为可选；多个筛选条件组合使用。中文、空格和 DOI 中的特殊字符应使用 URL 编码。

04 / RESPONSE

按 ID 递增，逐页读取。

列表始终按 id ASC 排序，不按相关度或发表日期排序。仅当 pagination.has_more 为 true 时，将 next_cursor 作为下一次的 cursor，并保留相同筛选条件；读到 false 后停止。

响应结构示意 · 非真实馆藏记录

{
  "items": [{
    "id": 123,
    "title": "Example article title",
    "title_zh": "示例中文题名",
    "authors": "Example Author",
    "journal_code": "AMJ",
    "journal_name": "Academy of Management Journal",
    "year": 2024,
    "month": 6,
    "volume": "67",
    "issue": "3",
    "page_start": "1",
    "doi": null,
    "doi_url": null,
    "article_type": null,
    "updated_at": "2026-09-27T00:00:00Z",
    "abstract_en": null,
    "abstract_zh": "此处为示意摘要，不是真实文献内容。"
  }],
  "pagination": {"limit": 1, "has_more": true, "next_cursor": 123}
}

最后一页的 next_cursor 为 null。无匹配结果返回 items: []，不是 404。读取期间数据可能更新，分页不构成固定时间点的快照。

缺失的元数据可能为 null 或空字符串，客户端应保留缺失状态，不推断补全。

单篇详情：默认包含现有完整解读

请求 /api/v1/papers/{id}，不附带列表筛选或分页参数。ID 为 1–9223372036854775807 的整数。响应中的 item 包含上述全部字段，以及下列字段。解读内容是否存在，以返回值和 content_availability 为准。

已有 deep_analysis 时，逐理论、假设和研究的阅读应优先使用该对象，并核对其 coverage。其余解读字段保留早期综合整理内容，可能与深读来自不同整理阶段；不要用早期概览替代逐项深读的具体结果和覆盖说明。

逐项深读对象 deep_analysis

theories、hypotheses、studies、arguments、evidence_map 和 documents 均为数组。条目通过 id 和 theory_ids、hypothesis_ids、study_ids 等字段关联；sources 保留来源标签及页、段或行的位置，关联材料用 document_id 标识。它们不提供文件链接。各类条目的完整字段定义见 OpenAPI JSON。

05 / RELIABILITY

遇到错误，按原因处理。

错误统一返回 {"error": {"code": "…", "message": "…", "request_id": "…"}}。联系管理员时提供状态码、请求时间与 request_id，不要发送密钥。