SuperAPI AI 工具集

finta-common-errors

办公与效率

查看项目

更新于 10-15 23:25

技能介绍

用途:该技能用于排查和修复 Finta(面向初创公司融资的 CRM,管理投资人管道、交易室、邮件同步与收款)的常见错误,包括轮次状态转换违规、CSV 导入时投资人去重失败、邮件服务商与交易跟踪器之间的管道同步中断,以及 Aurora AI 因公司资料不完整而无法给出建议等问题。

主要能力:按认证、授权、校验、限流、投递、上游可用性对故障分类;提供错误参考表(400 无效轮次转换、401 API 密钥失效、404 投资人不存在、409 重复投资人、422 缺少必填字段、429 超出速率限制、500 管道同步失败、502 Stripe webhook 失败)及对应修复方式;给出错误分类处理函数示例与调试指南。

使用方式:先准备可复现症状、时间戳与不透明关联标识,避免收集不必要的投资人或支付数据;用合成记录或最小权限只读操作复现,不要重放真实外联或支付动作;依次检查配置、作用域、模式映射与队列状态;应用最小可逆修正并验证正常与失败路径。可用命令验证连通性:curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $FINTA_API_KEY" https://api.trustfinta.com/v1/rounds。

限制与注意:Finta 限制每 API 密钥 60 请求/分钟,CSV 导入不受限流影响;轮次状态须按 Draft、Active、Closing、Closed 顺序前进,禁止回退;交易室链接默认 30 天后过期;CSV 需含 name、email、stage 列且日期为 YYYY-MM-DD。疑似凭据泄露、异常收件人或数据泄漏须立即上报。输出为事件回执,需脱敏账号标识、消息正文、联系信息与财务条款。