Skip to content

Shopify 凭据#

您可以使用这些凭据来验证以下使用 Shopify 的节点。

支持的认证方法#

  • Access token（推荐）：用于私有应用/单店使用。可由常规管理员创建。
  • OAuth2：用于公共应用。必须由合作伙伴账户创建。
  • API key：已弃用。

相关资源#

参考 Shopify 的认证文档了解有关该服务的更多信息。

使用 access token#

要配置此凭据，您需要一个 Shopify 管理员账户和：

  • 您的 Shop Subdomain 店铺子域
  • 一个 Access Token 访问令牌：创建自定义应用时生成。
  • 一个 APP Secret Key 应用密钥：创建自定义应用时生成。

要设置凭据，您需要创建并安装自定义应用：

  1. 输入您的 Shop Subdomain。
    • 您的子域在 URL 中：https://<subdomain>.myshopify.com。例如，如果完整 URL 是 https://n8n.myshopify.com，Shop Subdomain 就是 n8n。
  2. 在 Shopify 中，转到 Admin > Settings > Apps and sales channels。
  3. 选择 Develop apps。

  4. 选择 Create a custom app。

    没有看到这个选项？

    如果您没有看到这个选项，您的商店可能没有启用自定义应用开发。参考启用自定义应用开发了解更多信息。

  5. 在模态窗口中，输入 App name。

  6. 选择 App developer。应用开发者可以是店主或任何具有 Develop apps 权限的账户。
  7. 选择 Create app。
  8. 选择 Select scopes。在 Admin API access scopes 部分，选择您希望应用具有的 API 范围。
    • 要使用 Shopify 节点中的所有功能，添加 read_orders、write_orders、read_products 和 write_products 范围。
    • 参考 Shopify API Access Scopes了解有关可用范围的更多信息。
  9. 选择 Save。
  10. 选择 Install app。
  11. 在模态窗口中，选择 Install app。
  12. 打开应用的 API Credentials 部分。
  13. 复制 Admin API Access Token。将其作为 Access Token 输入到您的 n8n 凭据中。
  14. 复制 API Secret Key。将其作为 APP Secret Key 输入到您的 n8n 凭据中。

参考创建自定义应用和在 Shopify 管理后台为自定义应用生成访问令牌了解有关这些步骤的更多信息。

使用 OAuth2#

要配置此凭据，您需要一个 Shopify partner 账户和：

  • 一个 Client ID 客户端 ID：创建自定义应用时生成。
  • 一个 Client Secret 客户端密钥：创建自定义应用时生成。
  • 您的 Shop Subdomain 店铺子域

要设置凭据，您需要创建并安装自定义应用：

自定义应用开发

Shopify 提供了创建新应用的模板。以下说明仅涵盖设置 n8n 凭据所需的元素。参考 Shopify 的 Build dev docs了解有关构建应用和使用应用模板的更多信息。

  1. 打开您的 Shopify Partner dashboard。
  2. 从左侧导航选择 Apps。
  3. 选择 Create app。
  4. 在 Use Shopify Partners 部分，输入 App name。
  5. 选择 Create app。
  6. 当应用详情打开时，复制 Client ID。将其输入到您的 n8n 凭据中。
  7. 复制 Client Secret。将其输入到您的 n8n 凭据中。
  8. 在左侧菜单中，选择 Configuration。
  9. 在 n8n 中，复制 OAuth Redirect URL 并将其粘贴到 URLs 部分的 Allowed redirection URL(s) 中。
  10. 在 URLs 部分，为您的应用输入 App URL。这里输入的主机需要与 Allowed redirection URL(s) 的主机匹配，如您的 n8n 实例的基础 URL。
  11. 选择 Save and release。
  12. 从左侧菜单选择 Overview。此时，您可以选择通过将其安装到您的商店之一来 Test your app，或选择 Choose distribution 来公开分发它。
  13. 在 n8n 中，输入您安装应用的商店的 Shop Subdomain，无论是作为测试还是作为分发。
    • 您的子域在 URL 中：https://<subdomain>.myshopify.com。例如，如果完整 URL 是 https://n8n.myshopify.com，Shop Subdomain 就是 n8n。

使用 API key#

方法已弃用

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

要配置此凭据，您需要：

  • 一个 API Key API 密钥
  • 一个 Password 密码
  • 您的 Shop Subdomain 店铺子域：您的子域在 URL 中：https://<subdomain>.myshopify.com。例如，如果完整 URL 是 https://n8n.myshopify.com，Shop Subdomain 就是 n8n。
  • 可选： 一个 Shared Secret 共享密钥

常见问题#

以下是设置 Shopify 凭据的一些常见问题以及解决或排除故障的步骤。

Enable custom app development 启用自定义应用开发#

如果您没有看到 Create a custom app 的选项，说明没有人为您的商店启用自定义应用开发。

要启用自定义应用开发，您必须以店主身份登录或作为具有 Enable app development 权限的用户登录：

  1. 在 Shopify 中，转到 Admin > Settings > Apps and sales channels。
  2. 选择 Develop apps。
  3. 选择 Allow custom app development。
  4. 阅读提供的警告和信息并选择 Allow custom app development。

Forbidden credentials error 凭据被禁止错误#

如果您在测试凭据时收到 Couldn't connect with these settings / Forbidden - perhaps check your credentials 警告，这可能是由于您的应用的访问范围依赖关系。例如，read_orders 范围还需要 read_products 范围。查看您分配的范围和您尝试完成的操作。