N8N中文教程
集成节点/Built in_nodes/Credentials

Shopify 凭据#

你可以使用这些凭据对以下节点进行 Shopify 身份验证:

  • Shopify
  • Shopify Trigger

支持的身份验证方法#

  • 访问令牌(Access token,推荐):适用于私有应用(private apps)或单个商店使用。普通管理员即可创建。
  • OAuth2:适用于公开应用(public apps)。必须由合作伙伴账户(partner accounts)创建。
  • API 密钥(API key):已弃用(deprecated)。

相关资源#

更多关于该服务的信息,请参考 Shopify 的身份验证文档。

使用访问令牌#

要配置此凭据,你需要一个 Shopify 管理员账户,以及以下信息:

  • 你的 商店子域名(Shop Subdomain)
  • 一个 访问令牌(Access Token):在创建自定义应用时生成。
  • 一个 应用密钥(APP Secret Key):在创建自定义应用时生成。

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

  1. 输入您的 Shop 子域名(Shop Subdomain)
    • 您的子域名位于 URL 中:https://<subdomain>.myshopify.com。例如,如果完整 URL 是 https://n8n.myshopify.com,则 Shop 子域名为 n8n
  2. 在 Shopify 中,进入 Admin > Settings > Apps and sales channels
  3. 选择 Develop apps
  4. 选择 Create a custom app。 看不到此选项? 如果看不到该选项,可能是因为您的商店未启用自定义应用开发功能。请参考 启用自定义应用开发(Enable custom app development) 获取更多信息。
  5. 在弹出窗口中,输入 App 名称(App name)
  6. 选择一个 App 开发者(App developer)。该开发者可以是店铺所有者,或任何拥有 Develop apps 权限的账户。
  7. 选择 Create app
  8. 选择 Select scopes。在 Admin API access scopes 部分,选择您希望应用使用的 API 权限范围(scopes)。
    • 要在 Shopify 节点中使用全部功能,请添加 read_orderswrite_ordersread_productswrite_products 权限范围。
    • 有关可用权限范围的更多信息,请参阅 Shopify API Access Scopes。
  9. 选择 Save
  10. 选择 Install app
  11. 在弹出窗口中,选择 Install app
  12. 打开该应用的 API Credentials 部分。
  13. 复制 Admin API Access Token,并在您的 n8n 凭据中将其填入为 Access Token
  14. 复制 API Secret Key,并在您的 n8n 凭据中将其填入为 APP Secret Key

有关这些步骤的更多详细信息,请参阅 创建自定义应用(Creating a custom app) 和 在 Shopify 后台生成自定义应用的访问令牌(Generate access tokens for custom apps in the Shopify admin)。

使用 OAuth2

要配置此凭据,您需要一个 Shopify Partner 账户,并准备以下信息:

  • Client ID:创建自定义应用时生成。
  • Client Secret:创建自定义应用时生成。
  • 您的 Shop 子域名(Shop Subdomain)

要设置凭据,您需要创建并安装一个自定义应用: 自定义应用开发

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

  1. 打开您的 Shopify 合作伙伴仪表板。
  2. 从左侧导航栏中选择 Apps(应用)
  3. 选择 Create app(创建应用)
  4. Use Shopify Partners 部分,输入一个 App name(应用名称)
  5. 选择 Create app(创建应用)
  6. 当应用详情页面打开后,复制 Client ID(客户端 ID),并在您的 n8n 凭据中填写该值。
  7. 复制 Client Secret(客户端密钥),并在您的 n8n 凭据中填写该值。
  8. 在左侧菜单中,选择 Configuration(配置)
  9. 在 n8n 中复制 OAuth Redirect URL(OAuth 重定向 URL),然后将其粘贴到 URLs(URL) 部分的 Allowed redirection URL(s)(允许的重定向 URL) 字段中。
  10. URLs(URL) 部分,为您的应用输入一个 App URL(应用 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 密钥#

方法已弃用

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

要配置此凭据,您需要:

  • 一个 API Key(API 密钥)
  • 一个 Password(密码)
  • 您的 Shop Subdomain(商店子域名):您的子域名位于 URL 中:https://<subdomain>.myshopify.com。例如,如果完整 URL 是 https://n8n.myshopify.com,则 Shop Subdomain 为 n8n
  • 可选: 一个 Shared Secret(共享密钥)

常见问题#

以下是设置 Shopify 凭据时的一些常见问题,以及相应的解决或排查步骤。

启用自定义应用开发#

如果你没有看到 创建自定义应用(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) 的警告,这可能是由于你的应用访问范围(access scope)依赖关系导致的。例如,read_orders 权限范围同时也需要 read_products 权限范围。请检查你已分配的权限范围,并确认其是否满足你尝试执行的操作需求。

聊天查看文档 此页面对你有帮助吗? !赞有帮助 !踩无帮助 感谢你的反馈! 提交 上一篇 seven credentials 下一篇 Shuffler credentials 由 Material for MkDocs Insiders 提供支持