2. Refresh Pipedrive tokens

工作流名称

1. Refresh Pipedrive tokens

主要功能和亮点

该工作流实现了Pipedrive API的OAuth 2.0访问令牌自动刷新机制，确保访问令牌在过期后能自动更新，无需人工干预。通过结合Supabase数据库存储和管理访问与刷新令牌，提升了令牌管理的安全性和可靠性。工作流设计灵活，也适用于其他需要OAuth 2.0令牌刷新的第三方应用。

解决的核心问题

OAuth 2.0访问令牌通常有有效期限，过期后API调用会失败。此工作流解决了访问令牌失效导致系统无法正常调用Pipedrive接口的问题，自动检测令牌失效并调用刷新接口更新令牌，保障API调用的连续性和稳定性。

应用场景

• 需要频繁调用Pipedrive API且依赖OAuth 2.0认证的自动化系统。
• 任何基于OAuth 2.0授权机制，需自动管理访问和刷新令牌的业务场景。
• SaaS产品或内部工具中集成Pipedrive或类似平台API时的令牌自动维护。
• 开发者希望自建OAuth 2.0令牌刷新流程以增强掌控力。

主要流程步骤

1. 用户认证时，将获取的访问令牌(access token)和刷新令牌(refresh token)保存到Supabase数据库。
2. 收到API请求时，从Supabase获取对应的访问令牌。
3. 使用访问令牌调用Pipedrive API（示例中为搜索联系人API）。
4. 判断API返回是否因“访问令牌无效”导致失败。
5. 若令牌无效，触发刷新流程：调用本地Webhook接口请求刷新访问令牌。
6. 使用刷新令牌调用Pipedrive OAuth接口，获取新的访问令牌和刷新令牌。
7. 更新Supabase数据库中的令牌信息。
8. 使用新的访问令牌重新调用API，或返回错误信息。

涉及的系统或服务

• Pipedrive API：用于访问联系人数据和OAuth令牌管理。
• Supabase数据库：存储和管理访问令牌及刷新令牌。
• n8n自动化平台节点：包括HTTP请求、Webhook、条件判断（IF）、代码执行等。
• 本地Webhook服务：处理刷新令牌的业务逻辑。
• OAuth 2.0认证机制：实现令牌的获取和刷新。

适用人群或使用价值

• 技术开发者和自动化工程师，需实现稳定的Pipedrive API集成。
• SaaS产品团队，需自主管理第三方OAuth 2.0认证流程。
• 业务系统依赖Pipedrive数据且要求高可用性API访问。
• 希望提升令牌管理安全性与自动化水平的企业或个人用户。

---

该工作流通过完整的访问令牌刷新机制，确保Pipedrive API调用的连续稳定，减少认证中断风险，提升业务流程的自动化和安全性。同时，设计通用，方便迁移到其他OAuth 2.0支持的API服务。