SuperAPI AI 工具集

protocolsio-integration

写作与研究

查看项目

更新于 10-15 20:34

技能介绍

用途:该技能提供与 protocols.io API v3 的完整集成,用于以程序化方式访问和管理科学实验方案,适合方案检索、创作、更新、发布、协作及数据导出等任务。

主要能力:

  1. 认证与访问:支持客户端访问令牌与 OAuth 流程,包括生成授权链接、换取访问令牌、刷新过期令牌、管理速率限制与权限。
  2. 方案操作:按关键词、DOI 或分类搜索方案;获取含全部步骤的详情;创建带元数据与标签的方案;更新方案信息与设置;增删改及重排步骤;处理材料与试剂;发布并分配 DOI;收藏方案;生成方案 PDF。
  3. 讨论与协作:查看方案级与步骤级评论,创建评论和嵌套回复,编辑或删除自己的评论。
  4. 工作区管理:列出和访问用户工作区,获取工作区详情与成员列表,申请加入,列出工作区方案,在工作区内创建方案,管理权限与协作。
  5. 文件操作:搜索工作区文件和文件夹,上传带元数据与标签的文件,下载并校验上传,组织文件夹层级,更新文件元数据,删除与恢复文件。
  6. 附加功能:管理用户资料与设置,查询最新发布方案,创建和跟踪实验记录,接收管理通知,导出组织数据用于归档。

使用方式:所有请求的基础 URL 为 https://protocols.io/api/v3,需在请求头加入 Authorization: Bearer YOUR_ACCESS_TOKEN,多数端点使用 JSON,格式为 Content-Type: application/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 需指数退避;需有效访问令牌,涉及工作区或私有方案时需相应权限;文件上传受工作区大小和类型限制。官方 API 文档见 https://apidoc.protocols.io/,平台见 https://www.protocols.io/。具体收费标准、平台支持范围等资料暂未提供。