用途:该技能提供对 protocols.io API v3 的完整集成,用于以编程方式管理科学实验方案(protocols),覆盖方案发现、创建、更新、发布、协作、文件与实验记录等场景。
主要能力:
- 认证与访问:使用访问令牌或 OAuth 流程,支持生成授权链接、交换授权码、刷新令牌、管理速率限制与权限。
- 方案操作:按关键词、DOI 或分类搜索方案;获取含步骤的详细内容;创建、更新、发布方案并签发 DOI;管理步骤与材料试剂;收藏方案;生成 PDF。
- 讨论与协作:查看方案级和步骤级评论,创建评论与嵌套回复,编辑或删除自己的评论。
- 工作区管理:列出和访问工作区,查看成员与权限,申请加入,列出或创建团队方案。
- 文件操作:搜索、上传、下载、组织、更新元数据、删除与恢复文件。
- 附加功能:管理个人资料、查询近期发布方案、创建实验记录、接收通知、导出组织数据。
使用方式:所有请求基址为 https://protocols.io/api/v3,需在请求头加入 Authorization: Bearer YOUR_ACCESS_TOKEN。多数端点支持 JSON,并可通过 content_format 参数选择 json、html 或 markdown 格式。速率限制方面,标准端点约每分钟 100 次,PDF 端点每分钟 5 次(已登录)或 3 次(未登录),遇到 HTTP 429 应使用指数退避重试。技能按任务提供参考文件:authentication.md、protocols_api.md、discussions.md、workspaces.md、file_manager.md、additional_features.md。
适用场景:方案检索与引用、创建并发布带 DOI 的方案、团队工作区协作、实验执行记录与数据上传、方案集合备份迁移,以及构建与 protocols.io 交互的工具。
限制:需自行获取有效访问令牌并妥善保管;权限受工作区角色与方案可见性约束;文件上传受大小与类型限制;具体端点参数、错误码与完整示例需查阅对应参考文件及官方 API 文档 https://apidoc.protocols.io/。