文档应用和集成
连接 Shippo 进行配送
添加 Shippo API 密钥、确认连接并安全断开 Shippo。
当您希望 Runner 使用您的 Shippo 账户进行配送和履行时，连接 Shippo。该连接使用 Shippo 提供的 API 密钥。
开始前
入口路径： 项目 → 应用 → 商店应用 → Shippo
您需要：
- Shippo 账户和当前的 Shippo API 密钥；
- 权限将该账户连接到 Runner 工作区；以及
- 意识到断开 Shippo 会删除其密钥并为工作区中的所有项目禁用它。
不要将 API 密钥粘贴到聊天或文档中。
Shippo 控制和结果
| 控制 | 为什么有用 | 接下来会发生什么 |
|---|---|---|
| 连接 | 打开 Shippo 设置。 | Runner 要求输入 Shippo API 密钥。 |
| Shippo API 密钥 | 标识您的 Shippo 账户。 | Runner 检查密钥格式，当值无效时显示错误。 |
| 眼睛图标 | 让您检查值以查找输入错误。 | 在隐藏和可见文本之间切换字段。在共享屏幕前再次隐藏。 |
| 对话框连接 | 提交密钥。 | 成功时，Runner 关闭对话框、清除字段并将卡更改为已连接。 |
| 取消或关闭 | 不提交而离开设置。 | Runner 清除从对话框输入的密钥。 |
| 删除或断开连接 | 开始删除。 | Runner 打开断开 Shippo？，显示工作区范围的影响。 |
| 确认断开连接 | 删除保存的连接。 | Runner 删除 API 密钥并为所有工作区项目禁用 Shippo。 |
连接 Shippo
- 打开项目 → 应用。
- 找到 Shippo 并选择连接。
- 从您打算使用的 Shippo 账户复制 API 密钥。
- 将其粘贴到 Shippo API 密钥。
- 如果 Runner 报告密钥无效，请返回 Shippo 并重新复制，而不是凭猜测编辑密钥。
- 在对话框中选择连接。
- 等待成功消息并确认卡显示其已连接的断开连接控制。
- 使用安全测试数据验证配送工作流，然后再依赖它处理客户订单。
断开连接或替换密钥
选择卡的断开连接控制并阅读断开 Shippo？。仅在可以接受删除密钥并为工作区中的每个项目禁用 Shippo 时才确认。
要使用不同的密钥，请断开当前集成、确认卡不再连接，然后使用替换密钥完成连接工作流。
如果 Shippo 无法连接
- API 密钥无效表示该值与接受的 Shippo 密钥格式不匹配。
- 无法连接 Shippo 表示 Runner 未完成提供商连接。保持密钥私密，确认它在 Shippo 中是最新的，然后从卡重试。
- 如果对话框关闭但卡未连接，请在再次提交前刷新应用。
- 如果断开连接失败，假设现有密钥仍然活跃。
- 已连接的卡不能证明费率、标签、承运商或特定发货有效。使用安全测试数据单独验证这些操作。