SuperAPI AI 工具集

attio-hello-world

数据与分析

查看项目

更新于 10-15 22:42

技能介绍

用途:以最小且安全的方式验证 Attio REST 连接,用于检查新 token、确认工作区可访问性,且不写入或修改任何 CRM 数据。

前置条件:一个已命名的仓库,以及非生产或经批准的工作区;单工作区访问令牌或 OAuth 访问令牌;对象列表端点所需的 object_configuration:read 权限范围;支持 HTTPS 与 JSON 的运行时。

主要能力与用法:基础 URL 为 https://api.attio.com/v2。请求头使用 Authorization: Bearer <access_token>,推荐 Bearer 认证。先调用 GET /v2/objects,并校验返回的 { data: [...] } 结构;凭据不得出现在源码、输出、异常或请求日志中。先确认仓库、运行时、工作区别名、密钥来源与已授予权限;加入或检查一个显式注入基础 URL 与 Bearer 头的小型请求封装;带有限超时请求 /objects,记录状态码与内容类型;成功后仅记录可安全暴露的对象 slug 或数量,并断言至少一个预期对象对工作区可见;补充成功及失败处理的 fixture 测试。

适用场景:新令牌接入前的连通性验证、工作区身份确认、对象发现。

限制与边界:不要为首次只读验证添加创建、更新、断言或删除调用;绝不打印访问令牌或持久化原始工作区响应。错误处理:401 时检查凭据注入并更换无效令牌;403 时确认 object_configuration:read 权限,不要扩大其他范围;非 JSON 响应时保留状态与内容类型并停止解析;出现意外工作区数据时停止并核实工作区身份。输出应返回脱敏配置、状态、响应信封断言、安全对象摘要、fixture 测试结果及下一集成边界。官方文档等资料暂未提供完整细节。