跳到主要内容

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. 复制 Admin 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 权限范围。请检查您已分配的权限范围以及您尝试执行的操作。