SuperAPI AI 工具集

pipefy-api-fallback

编程与开发

查看项目

更新于 10-15 19:48

技能介绍

用途:这是 Pipefy 工具包的三级(Tier 3)最后兜底方案,仅在前两级失败后启用——即专用操作(如 create_card、get_phase_cards、update_pipe 等)不可用或异常失败,且内省(execute_graphql 与 schema 内省)也无法解决时,绕过工具包连接直接调用 Pipefy GraphQL API。不要因单次失败就跳到本层,测试新变更应留在第二级。

主要能力:通过 https://app.pipefy.com/graphql 执行查询、变更与公共 schema 内省;通过 https://app.pipefy.com/oauth/token 获取 OAuth2 令牌。认证优先使用 Service Account(客户端凭据),也可用 PAT(PIPEFY_PAT 或 PIPEFY_TOKEN,新集成已弃用)。请求头必须带 Bearer 前缀。读取任何 PIPEFY_* 变量前须告知用户并获同意,且只列变量名不打印值。

使用方式:先按三级顺序排查;确认需直连后获取令牌,再以 curl 发送 GraphQL 请求。示例:curl -s -X POST https://app.pipefy.com/graphql -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"query": "{ me { id name } }"}' | jq .。内省可查询 __schema 与 __type。

限制与注意:GraphQL 错误(含语法错误)返回 HTTP 200,需检查 errors 数组与 extensions.code;401 为认证问题,500 可能是请求体非合法 JSON 或 API 故障。写入报错时不要盲目重试,先重读目标(get_cards、get_phase_cards_count 等)确认是否已生效;CreateCardInput 无幂等键,重读是唯一安全路径。INTERNAL_SERVER_ERROR 不要重试同一载荷。跨管道创建卡片、pipesCount 与成员范围差异、invite_members 静默接受错误邮箱等为已知行为。所有三级与外部资源均失败后,才向用户说明已尝试内容、原始错误并给出具体变通方案,然后停止,不要循环。