freeagent-api

该技能面向 FreeAgent（面向自由职业者与小企业的在线会计系统）的 API 智能导航与工作流编排，用于管理发票、联系人、项目、费用、工时记录及其他财务数据。主要能力：按任务定位资源文件（OAuth 与令牌管理、联系人与组织、会计对象、银行与对账、错误与速率限制等生产模式、实战示例、完整端点参考）；按 HTTP 方法区分列出、创建、更新、删除；提供 bash 与 Python 请求模板及可复用客户端类。用法要点：生产地址为 https://api.freeagent.com/v2/，沙箱为 https://api.sandbox.freeagent.com/v2/；日期用 ISO 8601（YYYY-MM-DD），时间戳用 YYYY-MM-DDTHH:MM:SSZ；请求需带 Authorization: Bearer $FREEAGENT_ACCESS_TOKEN；监控 X-RateLimit-Remaining 并对 429 实施重试；响应为带资源包装的 JSON（如 {"contact": {...}}）。限制与安全规则：默认按只读分析处理，除非用户明确要求创建、更新或删除；歧义时须先询问，不得推断写入意图。所有写操作前须展示完整请求预览并等待明确肯定确认，歧义回复视为拒绝，且默认使用沙箱，除非用户明确指定生产环境。删除财务记录、创建或修改银行交易与对账、批量操作、变更发票状态等高危操作须确认两次。不得记录、回显或显示令牌值，不得将凭据写入源码，仅用环境变量；令牌过期（401）时引导重新认证而非静默刷新。速率限制为每分钟 120 次、每小时 3600 次请求。