文档应用和集成
排查应用连接问题
诊断应用加载、凭证、授权、审查、重新连接和断开连接问题。
当应用无法加载、连接、重新连接、保存其工具访问或按预期断开连接时，使用本指南。从 Runner 实际显示的状态开始，而不是盲目重复提供商流程。
入口路径： 项目 → 应用
开始前
- 确认您为预期的项目和工作区打开了应用。
- 清除搜索应用和任何代理应用类别过滤器。
- 刷新页面一次并等待连接状态加载。
- 阅读确切的卡状态：连接、连接中...、已连接、重新连接、待审查或操作所需通知。
- 仅打开与该状态匹配的恢复操作。
- 永远不要在支持消息或屏幕截图中包含 API 密钥、密钥、身份文件、支付详情或完整提供商回调 URL。
重要控制和结果
| 控制 | 选择后会发生什么 |
|---|---|
| 清除搜索 | 删除当前代理应用搜索，以便可用目录可以再次出现。 |
| 连接 / 连接并授权 | 为该应用打开设置或外部授权流程。 |
| 重新连接（显示时） | 为现有提供商连接重新启动授权。 |
| 重试 | 重复当前面板显示的失败目录、工具列表或连接请求。 |
| 继续入职 | 当需要操作时返回现有 Stripe 入职流程。 |
| 断开连接 | 打开确认或开始记录的删除流程；在更改提供商端凭证前验证保存的状态。 |
症状和恢复表
| 您看到的 | 可能的含义 | 安全的下一步操作 |
|---|---|---|
| 应用缺失 | 搜索、类别、工作区访问或条件功能隐藏了它。 | 清除搜索、选择全部，然后确认该功能对此工作区可用。 |
| 卡一直在加载 | Runner 尚未解决保存的连接。 | 刷新应用一次。避免在状态未知时提交另一个连接。 |
| 未找到应用 | 没有代理应用与当前过滤器匹配。 | 选择清除搜索。 |
| 连接无反应 | 必需字段为空或无效，或提供商流程无法启动。 | 阅读字段错误、重新复制所需值，并在适用时允许提供商弹出窗口。 |
| **连接中...**未完成 | 外部授权被关闭、阻止或从未返回结果。 | 返回应用、刷新状态，然后如果 Runner 提供，使用重新连接。 |
| 提供商显示成功但 Runner 没有 | Runner 尚未确认可用连接。 | 重新打开应用。仅将已连接视为成功；使用重新连接而不是创建重复项。 |
| 重新连接 | 现有授权需要关注。 | 选择它并再次完成提供商流程。 |
| 待审查 | Stripe 正在审查提交的详情。 | 遵循操作通知；不要仅为了删除标签而启动另一个账户。 |
| 需要 Stripe 操作 | Stripe 需要信息或已暂停功能。 | 查看立即到期、稍后到期、审查中、支付和付款通知，然后在显示时使用继续入职。 |
| API 密钥或密钥被拒绝 | 该值错误、已过期、来自错误的账户或此集成不接受。 | 从提供商重新复制。不要凭猜测编辑密钥。 |
| Shopify 域无效 | 该值不是永久 Shopify 商店域。 | 使用 your-store.myshopify.com，而不是自定义店面域。 |
| 代理应用授权窗口被阻止 | 浏览器阻止了外部流程。 | 允许 Runner 的弹出窗口并再次启动连接并授权。 |
| 代理应用工具加载失败 | Runner 无法检索该应用的工具列表。 | 在应用详情中选择重试。 |
| 工具开关报告失败 | 新工具设置未保存。 | 等待开关刷新、确认其当前状态，然后重试一次。 |
| 断开连接报告失败 | Runner 未确认删除。 | 假设现有连接仍然活跃，在再次尝试前重新打开应用。 |
提供商特定检查
Stripe
- 使用重新连接或继续入职继续现有入职尝试。
- 阅读操作要求而不是仅依赖卡颜色。
- 已发布的店面仍可能有支付暂停或不可用。
- 仅在 Runner 有关联账户后使用 Stripe 仪表板操作。
电子邮件
- 失败的开关更改返回到保存的状态。
- 启用的开关不能证明特定电子邮件已传递。
- 使用安全测试数据验证商店事件、收件人、电子邮件配置和当前发布的版本。
Shippo
- 从预期账户重新复制 Shippo API 密钥。
- 已连接的卡不验证费率、承运商、标签或发货创建。
Shopify
- 使用永久
myshopify.com域。 - 如果工作区已有已连接的商店，请在断开前查看它。
- 当连接链接过期或返回的商店与您输入的域不匹配时重新启动授权。
CJ Dropshipping
- 确认 API 密钥属于您打算使用的 CJ 账户。
- 断开连接后，Runner 回退到共享 CJ 账户，因此在未来供应商操作前验证账户上下文。
4PX
- 确认 API 密钥和密钥属于同一账户并在正确的字段中。
- 已连接的卡不能证明目的地或订单符合履行条件。
代理应用
- 整个部分或单个应用可能有条件地不可用。
- 在将应用视为缺失前清除过滤器。
- 在重新连接前查看工具开关；不要仅为了简化设置而授予更多访问权限。
断开连接失败或产生不确定的结果
- 保持提供商账户和当前商店操作不变。
- 重新打开项目 → 应用并检查卡状态。
- 如果它仍显示已连接，则将连接视为活跃。
- 在您了解活跃结账、电子邮件、配送、供应商或履行工作是否仍依赖它们之前，不要删除提供商端凭证。
- 仅在状态清晰后重试 Runner 断开连接。
安全地寻求帮助
提供：
- 应用名称；
- 确切的可见状态和错误文本；
- 问题是在连接、返回、管理工具还是断开连接时发生；
- 项目 URL（不含密钥查询值）；以及
- 隐私安全的屏幕截图（如果它实质上显示了问题）。
不要提供实际的 API 密钥、密钥、提供商密码、身份文件、支付详情、客户数据或隐藏的授权参数。