用途:Zenodo 是由 CERN 开发、欧盟委员会资助的开放获取数字仓库,研究者可存入数据集、软件、出版物、报告等研究数字产物。Zenodo 为每次上传分配 DOI,保证长期可引用与可发现。其 API 提供对仓库的编程访问,支持搜索记录、获取元数据、创建沉积条目、上传文件和管理社区,遵循 FAIR 原则,并可与 GitHub 集成实现软件自动归档。适用对象包括研究人员、数据馆员和研究基础设施团队,用于自动化数据发布流程、构建数据发现工具、将归档集成到 CI/CD 流水线,以及为机构仓库收割元数据。
主要能力:搜索与获取已发布记录(数据集、软件、出版物);创建和管理沉积条目并上传文件;发布条目并获得 DOI;按社区筛选记录;支持版本化、访问控制和 DataCite 元数据模式。
认证:大多数写操作和访问受限记录需要认证。在 https://zenodo.org/ 注册后,进入 Settings > Applications > Personal access tokens 生成令牌(作用域如 deposit:write、deposit:actions),通过 access_token 查询参数或 Authorization 请求头传入。公开记录只读访问无需认证,但认证请求速率限制更高。
核心端点: records(GET https://zenodo.org/api/records)用于搜索,参数含 q(Elasticsearch 语法)、type、communities、sort、size(默认 10,最大 9999)、page。 例如:curl "https://zenodo.org/api/records?q=climate+change&type=dataset&sort=mostrecent&size=5"。 depositions(GET https://zenodo.org/api/deposit/depositions)用于列出、创建和管理上传,参数含 access_token(必填)、q、sort、size。创建示例:curl -X POST "https://zenodo.org/api/deposit/depositions?access_token=YOUR_TOKEN" -H "Content-Type: application/json" -d '{"metadata": {"title": "My Dataset", "upload_type": "dataset", "description": "Sample dataset", "creators": [{"name": "Doe, Jane"}]}}'。
典型用法:按主题检索数据集、归档 GitHub 仓库(创建空沉积、向 bucket URL 上传文件、添加元数据并发布)、按社区收割记录(curl "https://zenodo.org/api/records?communities=astronomy&size=100&sort=mostrecent")。
速率限制:认证请求高于匿名请求。Zenodo 未公开确切的速率数值,一般建议匿名访问低于每分钟 60 次、认证访问低于每分钟 100 次。超限返回 HTTP 429,并提供 Retry-After 头指示重试时间。
参考:官方 API 文档 https://developers.zenodo.org/,Zenodo 主页 https://zenodo.org/,GitHub 集成指南 https://guides.github.com/activities/citable-code/,DataCite 元数据模式 https://schema.datacite.org/。具体收费、价格与平台信息资料未提供。