用途:在启用任何任务或 Webhook 写操作前,先做一次只读探测,验证 ClickUp API 的认证、JSON 解析和 Workspace 范围是否正确。
主要能力:使用 GET /api/v2/user 确认调用者身份,使用 GET /api/v2/team 获取已授权 Workspace(v2 中返回的 teams 即 Workspace),并与预期 Workspace ID 白名单比对。整个探测零写入,且不记录姓名、邮箱或令牌。
使用方式:准备个人令牌(仅限个人/测试用途)或面向用户应用的 OAuth 令牌;通过安全渠道提供预期 Workspace ID;在不会暴露令牌的服务端运行时执行。令牌经服务端受管密钥引用注入,放入 Authorization 头(OAuth 示例可用 ClickUp 文档中的 Bearer 形式),基础地址为 https://api.clickup.com/api/v2。依次确认认证模式、密钥引用、预期 Workspace、超时与零写入边界,检查本地客户端,请求授权用户并校验 JSON 用户对象,请求授权 teams 并比对 ID,记录状态、延迟、响应结构与脱敏后的 Workspace 匹配结果。
输出:返回认证模式、用户探测结果、授权 Workspace 数量、预期 ID 是否匹配、延迟和写入次数;成功结果必须明确报告零写入。
限制与边界:不得创建测试任务、重新生成令牌或扩大 OAuth Workspace 授权。401 或 OAuth 错误时检查密钥引用与认证流程,不要打印令牌;预期 Workspace 缺失时停止并请用户重新授权或选择正确账户;响应非 JSON 时仅采集元数据并排查代理/提供商行为;仅有浏览器运行时须先建立服务端边界,绝不暴露令牌。官方文档、认证与速率限制等资源暂未提供具体内容。