用途:该技能用于与 protocols.io API v3 集成,实现对科研实验方案(protocol)的程序化管理,包括发现、创建、更新、发布,以及工作区、讨论和文件协作。
主要能力:按关键词、DOI 或分类搜索方案;获取含全部步骤的详细信息;创建、更新、发布方案并获取 DOI;管理步骤、材料与试剂;查看与回复评论;管理团队工作区及权限;上传、下载、整理工作区文件;记录实验执行;导出组织数据。
必要用法:所有请求使用基地址 https://protocols.io/api/v3,并携带请求头 Authorization: Bearer YOUR_ACCESS_TOKEN。多数端点使用 JSON,可用 content_format 参数控制返回格式(json、html、markdown)。认证支持客户端访问令牌与 OAuth 令牌,具体流程需查阅 authentication.md 等参考文件。
限制:标准端点限速每分钟 100 次请求,PDF 端点每分钟 5 次(已登录)或 3 次(未登录);遇到 429 需实现指数退避。文件上传受工作区大小与类型限制,权限错误需核对工作区角色。官方 API 文档见 https://apidoc.protocols.io/。