SuperAPI AI 工具集

protocolsio-integration

写作与研究

查看项目

更新于 10-15 21:34

技能介绍

用途:该技能面向 protocols.io 平台,提供对 protocols.io API v3 的程序化访问,用于管理科学实验方案(protocol),覆盖协议发现、创建、更新、发布、协作与文件管理等场景。

主要能力: 一、认证与访问:使用访问令牌与 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)。

限制与注意:标准端点限速约每分钟 100 次请求,PDF 端点登录用户每分钟 5 次、未登录 3 次;遇到 HTTP 429 应实现指数退避重试;文件上传需注意工作区大小与类型限制及 multipart/form-data 编码;令牌应安全存储,不应写入代码或版本控制。

适用场景:协议检索与引用、团队实验方案库维护、实验执行记录、数据备份迁移以及与 protocols.io 交互的集成工具开发。

费用、价格与具体平台支持情况暂未提供。