用途:通过 LabArchives REST API 以编程方式操作电子实验记录本,适用于笔记本自动化、程序化备份、创建与管理条目和附件、生成站点报告,以及与 Protocols.io、Jupyter、REDCap 等第三方工具集成。
主要能力:认证与配置(需企业版许可证、API 访问密钥 ID 与密码、用户邮箱与外部应用密码);通过 users/user_access_info 获取用户 ID(UID),再用 users/user_info_via_id 获取详细信息;笔记本操作包括列出、备份(可含附件,默认生成 7z 归档)、获取 ID、成员与设置;条目与附件管理包括创建条目、添加评论、创建条目组件、上传附件,支持文档、图片、数据、科学格式与归档文件;站点报告为 Enterprise 功能,含详细使用报告、笔记本报告、PDF/离线生成报告、成员报告与设置报告;第三方集成支持 Protocols.io、GraphPad Prism、SnapGene、Geneious、Jupyter、REDCap、Qeios、SciSpace,新集成使用 OAuth,旧集成可能用 API 密钥。
使用方式:运行 python3 scripts/setup_config.py 生成 config.yaml,填入 api_url、access_key_id、access_password;区域端点:US/国际 https://api.labarchives.com/api,澳大利亚 https://auapi.labarchives.com/api,英国 https://ukapi.labarchives.com/api。备份示例:python3 scripts/notebook_operations.py backup --uid USER_ID --nbid NOTEBOOK_ID;条目上传示例:python3 scripts/entry_operations.py upload --uid USER_ID --nbid NOTEBOOK_ID --entry-id ENTRY_ID --file /path/to/file.pdf。安装 Python 包装器:git clone https://github.com/mcmero/labarchives-py 后 cd labarchives-py,再 uv pip install .。
限制与注意:需企业版许可证并启用 API 访问;部分报告为 Enterprise 功能;应实现速率限制延迟、错误处理,凭证存入环境变量或安全配置文件,备份后验证完整性;常见错误包括 401、404、403、空响应与附件上传失败。其他细节暂未提供。