SuperAPI AI 工具集

fathom-sdk-patterns

数据与分析

查看项目

更新于 10-15 23:25

技能介绍

用途:帮助开发者构建一个边界清晰的 Fathom API 客户端,使同意、数据处理、幂等、脱敏和人工归属等要求显式化,适用于构建可复用的 Fathom 客户端或会议数据管道。

主要能力:提供 Python 与 TypeScript 两种客户端模式,封装会议列表、转录文本和摘要等接口;在边界处校验请求/响应契约;使用稳定 ID、有界重试和脱敏遥测处理同步与跟进操作。

使用方式:凭证仅从已批准的密钥管理器注入;用 mock 做单元测试,并在上线前运行一次合成开发集成检查。示例中客户端通过环境变量 FATHOM_API_KEY 读取密钥,请求头使用 X-Api-Key,基础地址为 https://api.fathom.ai/external/v1。

限制与错误处理:401 表示密钥无效需重新生成,404 表示录音未找到需核对 ID,429 表示限流(60/分钟)需退避重试。日志只记录不透明 ID 和结果,绝不记录录音、转录、联系人或令牌。

前置条件:需要限定范围的开发凭证、已批准的录音/数据政策、合成测试数据和现有测试约定。