Shopify 凭据#
您可以使用这些凭据为以下节点进行 Shopify 身份验证。
支持的认证方式#
- 访问令牌(推荐):适用于私有应用/单店铺使用。可由普通管理员创建。
- OAuth2:适用于公共应用。必须由合作伙伴账户创建。
- API 密钥:已弃用。
相关资源#
有关该服务的更多信息,请参阅 Shopify 身份验证文档。
使用访问令牌#
要配置此凭据,您需要拥有 Shopify 管理员账户以及:
- 店铺子域名
- 访问令牌:在创建自定义应用时生成。
- 应用密钥:在创建自定义应用时生成。
要设置凭据,您需要创建并安装一个自定义应用:
-
输入您的店铺子域名。
- 您的子域名包含在 URL 中:
https://<子域名>.myshopify.com。例如,如果完整 URL 是https://n8n.myshopify.com,则店铺子域名为n8n。
- 您的子域名包含在 URL 中:
-
在 Shopify 中,转到 管理员 > 设置 > 应用和销售渠道。
-
选择开发应用。
-
选择创建自定义应用。
没有看到此选项?
如果您没有看到此选项,可能是因为您的店铺未启用自定义应用开发。更多信息请参阅启用自定义应用开发。
-
在模态窗口中,输入应用名称。
-
选择应用开发者。应用开发者可以是店铺所有者或任何具有开发应用权限的账户。
-
选择创建应用。
-
选择选择权限范围。在管理员 API 访问权限范围部分,选择您希望应用拥有的 API 权限范围。
- 要使用 Shopify 节点中的所有功能,请添加
read_orders、write_orders、read_products和write_products权限范围。 - 有关可用权限范围的更多信息,请参阅 Shopify API 访问权限范围。
- 要使用 Shopify 节点中的所有功能,请添加
-
选择保存。
-
选择安装应用。
-
在模态窗口中,选择安装应用。
-
打开应用的 API 凭据 部分。
-
复制 Admin API 访问令牌。将其作为访问令牌输入到您的 n8n 凭据中。
-
复制 API 密钥。将其作为应用密钥输入到您的 n8n 凭据中。
有关这些步骤的更多信息,请参阅创建自定义应用和在 Shopify 管理员中为自定义应用生成访问令牌。
使用 OAuth2#
要配置此凭据,您需要拥有 Shopify 合作伙伴 账户以及:
- 客户端 ID:在创建自定义应用时生成。
- 客户端密钥:在创建自定义应用时生成。
- 店铺子域名
要设置凭据,您需要创建并安装一个自定义应用:
自定义应用开发
Shopify 提供了创建新应用的模板。以下说明仅涵盖设置 n8n 凭据所必需的元素。有关构建应用和使用应用模板的更多信息,请参阅 Shopify 的构建开发文档。
- 打开您的 Shopify 合作伙伴仪表板。
- 从左导航栏中选择应用。
- 选择创建应用。
- 在使用 Shopify 合作伙伴部分,输入应用名称。
- 选择创建应用。
- 当应用详情打开时,复制客户端 ID。将其输入到您的 n8n 凭据中。
- 复制客户端密钥。将其输入到您的 n8n 凭据中。
- 在左侧菜单中,选择配置。
- 在 n8n 中,复制 OAuth 重定向 URL 并将其粘贴到 URLs 部分的允许的重定向 URL 中。
- 在 URLs 部分,为您的应用输入一个应用 URL。此处输入的主机需要与允许的重定向 URL 的主机匹配,例如您的 n8n 实例的基础 URL。
- 选择保存并发布。
- 从左侧菜单中选择概览。此时,您可以选择测试您的应用(将其安装到您的某个店铺)或选择分发(公开发布)。
- 在 n8n 中,输入您安装该应用的店铺的店铺子域名(无论是作为测试还是分发)。
- 您的子域名包含在 URL 中:
https://<子域名>.myshopify.com。例如,如果完整 URL 是https://n8n.myshopify.com,则店铺子域名为n8n。
- 您的子域名包含在 URL 中:
使用 API 密钥#
方法已弃用
Shopify 不再生成带有密码的 API 密钥。请改用访问令牌方法。
要配置此凭据,您需要:
- API 密钥
- 密码
- 店铺子域名:您的子域名包含在 URL 中:
https://<子域名>.myshopify.com。例如,如果完整 URL 是https://n8n.myshopify.com,则店铺子域名为n8n。 - *可选:*共享密钥
常见问题#
以下是一些设置 Shopify 凭据时的常见问题以及解决或排查步骤。
启用自定义应用开发#
如果您没有看到创建自定义应用的选项,说明您的店铺尚未启用自定义应用开发。
要启用自定义应用开发,您必须以店铺所有者或具有启用应用开发权限的用户身份登录:
- 在 Shopify 中,转到 管理员 > 设置 > 应用和销售渠道。
- 选择开发应用。
- 选择允许自定义应用开发。
- 阅读提供的警告和信息,然后选择允许自定义应用开发。
凭据被禁止错误#
如果您在测试凭据时收到 无法使用这些设置连接 / 被禁止 - 请检查您的凭据 警告,这可能是由于您应用的访问权限范围依赖关系所致。例如,read_orders 权限范围也需要 read_products 权限范围。请检查您已分配的权限范围以及您尝试执行的操作。