用途:该技能提供与 protocols.io API v3 的完整集成,用于以编程方式访问和管理科学实验方案,包括方案、工作区、讨论、文件与协作功能。
主要能力:认证与访问(访问令牌与 OAuth 流程、刷新令牌、权限与速率限制);方案操作(按关键词、DOI 或分类搜索,获取详情,创建、更新、发布并生成 DOI,管理步骤与材料,收藏,生成 PDF);讨论与协作(方案级与步骤级评论、回复、编辑删除);工作区管理(列出与访问工作区、成员、权限、工作区内方案);文件操作(搜索、上传、下载、组织文件夹、更新元数据、删除与恢复);附加功能(个人资料、近期发布方案、实验记录、通知、数据导出)。
使用方式:所有请求基址为 https://protocols.io/api/v3,需在请求头加入 Authorization: Bearer YOUR_ACCESS_TOKEN。多数端点支持 JSON,可用 content_format 参数控制返回格式(json、html、markdown)。技能按任务提供参考文件:authentication.md、protocols_api.md、discussions.md、workspaces.md、file_manager.md、additional_features.md。
适用场景:方案发现与引用、创建与发布方案、团队工作区协作、实验执行记录与数据上传、方案集合备份迁移、构建与 protocols.io 交互的工具。
限制:标准端点速率限制为每用户每分钟 100 次请求,PDF 端点每分钟 5 次(已登录)或 3 次(未登录),需对 HTTP 429 实现指数退避;需有效令牌与相应工作区权限;文件上传受工作区大小与类型限制。具体收费、价格与平台支持范围暂未提供。