SuperAPI AI 工具集

pluggy-integration

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:为 Pluggy Open Finance API 提供集成规范,覆盖从 SDK 接入到数据同步的关键环节,帮助实现准确、可靠的集成。

主要能力(按影响优先级分类):

  1. 认证(CRITICAL,前缀 auth-):管理 API Key 与 Token。API Key 为后端令牌,有效期 2 小时,用于访问用户数据;Connect Token 为前端令牌,有效期 30 分钟,仅用于 Connect Widget。
  2. Connect Widget(CRITICAL,前缀 widget-):在前端应用中实现连接组件。
  3. Webhook 配置(CRITICAL,前缀 webhook-):实现数据实时同步。
  4. Item 生命周期(HIGH,前缀 item-):创建、更新和管理连接;含 MFA 流程处理。
  5. 错误处理(MEDIUM,前缀 error-):处理连接错误与边界情况。

使用方式:按需阅读各规则文件(如 rules/auth-api-keys.md、rules/widget-integration.md、rules/item-lifecycle.md),每个文件包含重要性说明、错误与正确代码示例、补充背景及 Pluggy 专属说明。完整指南见 AGENTS.md。

核心概念:连接同步由 Pluggy 负责,每 24/12/8 小时自动同步;用户仅在明确请求时触发更新。实体数据同步由集成方负责,在 item/updated webhook 时拉取全部数据;交易同步使用 transactions/* webhook 事件。Item 生命周期流程:用户用 Connect Token 打开 Widget、选择连接器并认证、Pluggy 创建 Item 并开始同步、Webhook 通知同步完成、后端用 API Key 读取数据、Pluggy 每日自动同步并由 webhook 触发数据刷新。

限制:资料未提供具体代码内容、收费或价格信息,相关细节暂未提供。