Skip to content

Shopify 凭证#

您可以使用这些凭证来验证以下节点与 Shopify 的连接:

支持的认证方式#

  • 访问令牌(推荐):适用于私有应用/单店铺使用。可由常规管理员创建。
  • OAuth2:适用于公共应用。必须由合作伙伴账户创建。
  • API 密钥:已弃用。

相关资源#

更多关于该服务的认证信息,请参考 Shopify 的认证文档

使用访问令牌#

要配置此凭证,您需要拥有 Shopify 管理员账户以及:

  • 您的 商店子域名
  • 一个 访问令牌:创建自定义应用时生成
  • 一个 应用密钥:创建自定义应用时生成

设置凭证需要创建并安装一个自定义应用:

  1. 输入您的 商店子域名
    • 子域名包含在 URL 中:https://<子域名>.myshopify.com。例如,完整 URL 是 https://n8n.myshopify.com,则商店子域名就是 n8n
  2. 在 Shopify 中,前往 管理员 > 设置 > 应用和销售渠道
  3. 选择 开发应用
  4. 选择 创建自定义应用

    没有看到这个选项?

    如果看不到此选项,可能您的商店未启用自定义应用开发功能。请参考启用自定义应用开发获取更多信息。

  5. 在弹窗中,输入 应用名称

  6. 选择 应用开发者。应用开发者可以是商店所有者或任何拥有 开发应用 权限的账户。
  7. 选择 创建应用
  8. 选择 选择权限范围。在 管理员 API 访问权限 部分,选择应用所需的 API 权限范围。
    • 要使用 Shopify 节点的全部功能,请添加 read_orderswrite_ordersread_productswrite_products 权限范围。
    • 更多可用权限范围信息,请参考 Shopify API 访问权限范围
  9. 选择 保存
  10. 选择 安装应用
  11. 在弹窗中,选择 安装应用
  12. 打开应用的 API 凭证 部分。
  13. 复制 管理员 API 访问令牌。将其作为 访问令牌 输入到您的 n8n 凭证中。
  14. 复制 API 密钥。将其作为 应用密钥 输入到您的 n8n 凭证中。

有关这些步骤的更多信息,请参考创建自定义应用在 Shopify 管理员中为自定义应用生成访问令牌

使用 OAuth2 认证#

要配置此凭证,您需要拥有 Shopify 合作伙伴账户以及:

  • 客户端 ID:创建自定义应用时生成
  • 客户端密钥:创建自定义应用时生成
  • 商店子域名

设置凭证需要创建并安装一个自定义应用:

自定义应用开发

Shopify 提供了创建新应用的模板。以下说明仅涵盖设置 n8n 凭证所需的要素。有关构建应用和使用应用模板的更多信息,请参阅 Shopify 的开发文档

  1. 打开您的 Shopify 合作伙伴控制台
  2. 在左侧导航栏选择 应用
  3. 选择 创建应用
  4. 使用 Shopify 合作伙伴 部分,输入 应用名称
  5. 选择 创建应用
  6. 当应用详情打开后,复制 客户端 ID 并填入您的 n8n 凭证
  7. 复制 客户端密钥 并填入您的 n8n 凭证
  8. 在左侧菜单中选择 配置
  9. 在 n8n 中复制 OAuth 重定向 URL,然后粘贴到 URLs 部分的 允许的重定向 URL 字段中
  10. URLs 部分,为您的应用输入一个 应用 URL。此处输入的主机名需要与 允许的重定向 URL 的主机名匹配,例如您的 n8n 实例的基础 URL
  11. 选择 保存并发布
  12. 从左侧菜单中选择 概览。此时您可以选择 测试应用(将其安装到您的某个商店)或 选择分发(公开发布应用)
  13. 在 n8n 中,输入您安装该应用的商店的 商店子域名(无论是测试安装还是正式分发)
    • 子域名位于 URL 中:https://<子域名>.myshopify.com。例如,如果完整 URL 是 https://n8n.myshopify.com,则商店子域名就是 n8n

使用 API 密钥#

方法已弃用

Shopify 不再生成带密码的 API 密钥。请改用 访问令牌 方法。

配置此凭证需要以下信息:

  • API 密钥
  • 密码
  • 商店子域名:子域名包含在 URL 中:https://<子域名>.myshopify.com。例如,完整 URL 是 https://n8n.myshopify.com,则商店子域名就是 n8n
  • 可选共享密钥

常见问题#

以下是设置 Shopify 凭证时的一些常见问题及解决方法。

启用自定义应用开发#

如果看不到 创建自定义应用 选项,说明您的商店尚未启用自定义应用开发功能。

要启用自定义应用开发,您必须以商店所有者身份或具有 启用应用开发 权限的用户登录:

  1. 在 Shopify 中,前往 管理员 > 设置 > 应用和销售渠道
  2. 选择 开发应用
  3. 选择 允许自定义应用开发
  4. 阅读警告和提供的信息后,选择 允许自定义应用开发

凭证禁止访问错误#

如果在测试凭证时收到 无法通过这些设置连接 / 禁止访问 - 请检查您的凭证 警告,可能是由于应用的访问范围依赖关系导致的。例如,read_orders 范围还需要 read_products 范围。请检查您已分配的范围和尝试执行的操作。