平台操作
账号和管理员 API、权限以及工作流控制。
网页业务操作均支持具有对应权限的 API Key。请求头可用 x-api-key 或 Authorization: Bearer；服务端仍逐次检查账号归属、组织角色和管理员身份。
| 网页功能 | 接口 |
|---|---|
| 资料、偏好、头像 | /api/account/profile、/api/account/preferences、/api/account/avatar |
| 密钥管理 | GET、POST、DELETE /api/account/keys，要求 account |
| 用量和积分 | GET /api/account/usage |
| 安全状态、安全日志 | GET /api/account/security、GET /api/account/security-log，要求 account |
| 设置密码、注销账号 | POST /api/account/password、POST /api/account/delete，要求 account |
| 组织、邀请、设备、邮箱、两步验证 | /api/auth/**，要求 account，接口定义见下文 |
| 通知 | GET、PATCH /api/notifications |
| 仓库设置、作者认领 | /api/repositories/{repositoryId}、/visibility、/author-claims |
| 提交论文、查询处理 | POST /api/repositories、GET /api/processing?repositoryId=... |
| 管理员总览 | GET /api/admin/overview |
| 用户与角色 | /api/admin/users、/api/admin/users/{userId}/role |
| 仓库管理 | /api/admin/repositories；/{repositoryId}/details、/visibility、/transfer、/delete |
| 作者认领管理 | GET /api/admin/author-claims；POST /api/admin/author-claims/{claimId}/revoke |
| 工作流管理 | /api/admin/jobs、/api/admin/jobs/{jobId}、/retry、/cancel |
| 诊断和产物下载 | /api/admin/jobs/{jobId}/diagnostics/{diagnosticId}/download、/artifacts/{artifactId}/download |
| 智能体配置与预设 | /api/admin/agent-config、/api/admin/agent-presets |
| 文章与作者联系 | /api/admin/articles、/api/admin/outreach |
全部 /api/admin/** 接口同时要求密钥包含 admin 权限、所属账号当前是管理员。管理员账号的普通密钥不具备管理权限。在密钥页面勾选“管理员密钥”即可创建。
机器可读目录
/api/openapi.json：业务接口目录及研究接口的详细定义。/api/auth/open-api/generate-schema：由实际安装的认证、组织和安全接口生成的完整定义。- 论文提交、处理及研究操作的请求格式见对应接口文档。目录中未含请求格式的条目仅用于发现接口，不能据此生成完整客户端。
创建受限密钥
curl -X POST https://citeark.co/api/account/keys \
-H "x-api-key: $CITEARK_API_KEY" -H 'Content-Type: application/json' \
--data '{"name":"research-reader","expiresIn":86400,"permissions":["read"]}'调用者需要 account 权限。子密钥权限和到期时间均不得超过调用密钥；完整密钥仅在创建时返回一次。撤销使用 DELETE /api/account/keys，请求体为 {"keyId":"..."}。
继续失败的工作流
curl -X POST "https://citeark.co/api/admin/jobs/$JOB_ID/retry" \
-H "x-api-key: $CITEARK_ADMIN_API_KEY" \
-H 'Content-Type: application/json' -H 'Idempotency-Key: repair-attempt-1' \
--data '{"mode":"continue"}'continue 创建关联的续跑任务；resume 复用有效的已发布计划；retry 重新排队原任务。Idempotency-Key 对 continue 和 resume 的创建去重；重试不确定的响应时保持同一个值。已有产物和任务来源关系保持可追溯。通过返回的任务编号查询进度；接口接受请求不代表科研结论已经验证成功。
密码、邮箱确认、第三方授权、两步验证码和支付确认仍按原规则执行。内部执行器及支付回调使用其服务凭证或签名，不属于网页用户操作。
公开内容也提供 GET /api/news、GET /api/news/{slug}、GET /api/daily、GET /api/daily/{date}、GET /api/profiles/{slug} 和 GET /api/venues?series=iclr&edition=2026。
对于具有同任务耐久检查点、失败于研究编译阶段的任务，管理员可以向
/api/admin/jobs/{jobId}/retry 提交 {"mode":"retry","compilerRepair":true}。
这会明确采用累计60分钟的编译修复时限，计入此前已消耗时间，并审计检查点身份；
检查点不匹配时停止恢复。论文预算与科研实验时限不变。
Codex 专用订阅账号
管理员 Agent 预设支持可选的 codexAccountId，仅适用于 Codex，使用小写字母、数字和连字符，最长 48 字符。填写已完成登录的专用账号编号后，执行 Agent 使用 ChatGPT 登录；设为 null 恢复 API 模式。后台表单和预设 POST/PATCH API 使用相同字段，管理员 API key 需含 admin 权限。接口不返回登录令牌。API 服务商配置仍用于独立评估，相关调用单独计费。