用途:该技能面向 protocols.io 平台,通过其 API v3 以编程方式管理科学实验方案,适用于协议检索、创建与更新、协作开发、工作区组织、评论反馈、文件管理、实验记录与数据导出等场景。
主要能力:认证与访问(客户端访问令牌和 OAuth 流程,含生成授权链接、兑换访问令牌、刷新令牌、管理速率限制与权限);协议操作(按关键词、筛选或 DOI 搜索,获取含步骤的详情,创建、更新、发布并签发 DOI,管理步骤与材料试剂,收藏协议,生成 PDF);讨论协作(查看协议级与步骤级评论,创建评论与嵌套回复,编辑删除自己的评论);工作区管理(列出与访问工作区、成员列表、请求加入、在工作区内创建协议、权限管理);文件操作(搜索文件夹、上传下载文件、按层级组织、更新元数据、删除恢复);附加功能(个人资料、近期发布协议、实验记录、通知、组织数据导出)。
使用方式:所有请求的基础 URL 为 https://protocols.io/api/v3,请求头需包含 Authorization: Bearer YOUR_ACCESS_TOKEN,多数端点使用 JSON,可用 content_format 参数指定 json、html 或 markdown。使用前先获取访问令牌并安全存储,再根据任务读取 references/ 目录下对应参考文件(authentication.md、protocols_api.md、discussions.md、workspaces.md、file_manager.md、additional_features.md)。
限制:标准端点速率限制为每用户每分钟 100 次请求;PDF 端点每分钟 5 次(已登录)或 3 次(未登录);遇到 429 需实现指数退避。文件上传受工作区大小与类型限制,权限错误需检查工作区角色。资料未提供具体价格与更多平台支持信息。