API 参考
arXiv 查询
GET /api/arxiv 查询 arXiv 论文元数据，或代理获取论文 PDF。
GET /api/arxiv 按 arXiv 链接或编号查询论文元数据，也可以流式代理返回论文 PDF。典型用法：先用它查元数据与 suggestedSlug，再调用 POST /api/repositories 完成索引。
鉴权
需要 read 权限：浏览器 session 或 API Key（x-api-key）。
请求
Query 参数：
| 参数 | 必填 | 说明 |
|---|---|---|
| input | 是 | arXiv 链接或编号，新式（如 2401.12345）与旧式（如 cs/0606050）均可；无法识别时返回 400 |
| 否 | 传 pdf=1 时返回 PDF 字节流而不是元数据 |
示例
curl "https://citeark.com/api/arxiv?input=https://arxiv.org/abs/2401.12345" \
-H "x-api-key: $CITEARK_API_KEY"curl "https://citeark.com/api/arxiv?input=2401.12345&pdf=1" \
-H "x-api-key: $CITEARK_API_KEY" \
-o paper.pdf响应（元数据模式）
成功返回 200：
{
"metadata": {
"arxivId": "2401.12345",
"absUrl": "https://arxiv.org/abs/2401.12345",
"pdfUrl": "https://arxiv.org/pdf/2401.12345",
"title": "…",
"authors": ["…"],
"abstract": "…",
"publishedAt": "2024-01-01T00:00:00Z",
"licenseUrl": "http://creativecommons.org/licenses/by/4.0/",
"paperLicense": "CC-BY-4.0",
"suggestedSlug": "…"
}
}| 字段 | 说明 |
|---|---|
| arxivId | 规范化后的 arXiv 编号 |
| absUrl | arXiv 摘要页地址 |
| pdfUrl | arXiv PDF 地址 |
| title | 论文标题 |
| authors | 作者列表 |
| abstract | 摘要 |
| publishedAt | 发表时间，可能为 null |
| licenseUrl | arXiv 记录的许可地址，可能为 null |
| paperLicense | 由 licenseUrl 映射出的论文许可枚举 |
| suggestedSlug | 由标题生成的建议仓库 slug，可直接用于 POST /api/repositories |
响应（pdf=1 模式）
流式代理返回 PDF 字节，响应头：
content-type: application/pdfcache-control: private, max-age=300
错误
错误统一形态为 {"error": "中文信息"}：
| 状态码 | 说明 |
|---|---|
| 400 | 无法识别的 arXiv 链接或编号 |
| 401 | 未登录或凭证无效 |
| 404 | 在 arXiv 上没有找到这篇论文 |
| 429 | 触发限流 |
| 502 | arXiv 接口暂时不可用，请稍后重试 |
限流
元数据查询 30 次/小时/账号；PDF 代理 10 次/小时/账号。超限返回 429，并携带 Retry-After 响应头。