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):在创建自定义应用时生成。
要设置凭据,您需要创建并安装一个自定义应用:
- 输入您的 Shop 子域名(Shop Subdomain)。
- 您的子域名位于 URL 中:
https://<subdomain>.myshopify.com。例如,如果完整 URL 是https://n8n.myshopify.com,则 Shop 子域名为n8n。
- 您的子域名位于 URL 中:
- 在 Shopify 中,进入 Admin > Settings > Apps and sales channels。
- 选择 Develop apps。
- 选择 Create a custom app。 看不到此选项? 如果看不到该选项,可能是因为您的商店未启用自定义应用开发功能。请参考 启用自定义应用开发(Enable custom app development) 获取更多信息。
- 在弹出窗口中,输入 App 名称(App name)。
- 选择一个 App 开发者(App developer)。该开发者可以是店铺所有者,或任何拥有 Develop apps 权限的账户。
- 选择 Create app。
- 选择 Select scopes。在 Admin API access scopes 部分,选择您希望应用使用的 API 权限范围(scopes)。
- 要在 Shopify 节点中使用全部功能,请添加
read_orders、write_orders、read_products和write_products权限范围。 - 有关可用权限范围的更多信息,请参阅 Shopify API Access Scopes。
- 要在 Shopify 节点中使用全部功能,请添加
- 选择 Save。
- 选择 Install app。
- 在弹出窗口中,选择 Install app。
- 打开该应用的 API Credentials 部分。
- 复制 Admin API Access Token,并在您的 n8n 凭据中将其填入为 Access Token。
- 复制 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 开发文档。
- 打开您的 Shopify 合作伙伴仪表板。
- 从左侧导航栏中选择 Apps(应用)。
- 选择 Create app(创建应用)。
- 在 Use Shopify Partners 部分,输入一个 App name(应用名称)。
- 选择 Create app(创建应用)。
- 当应用详情页面打开后,复制 Client ID(客户端 ID),并在您的 n8n 凭据中填写该值。
- 复制 Client Secret(客户端密钥),并在您的 n8n 凭据中填写该值。
- 在左侧菜单中,选择 Configuration(配置)。
- 在 n8n 中复制 OAuth Redirect URL(OAuth 重定向 URL),然后将其粘贴到 URLs(URL) 部分的 Allowed redirection URL(s)(允许的重定向 URL) 字段中。
- 在 URLs(URL) 部分,为您的应用输入一个 App URL(应用 URL)。此处输入的主机名必须与 Allowed redirection URL(s) 的主机名一致,例如您的 n8n 实例的基础 URL。
- 选择 Save and release(保存并发布)。
- 从左侧菜单中选择 Overview(概览)。此时您可以选择通过将应用安装到某个商店来 Test your app(测试您的应用),或选择 Choose distribution(选择分发方式) 以公开分发该应用。
- 在 n8n 中,输入您已安装该应用的商店的 Shop Subdomain(商店子域名),无论是作为测试还是正式分发。
- 您的子域名位于 URL 中:
https://<subdomain>.myshopify.com。例如,如果完整 URL 是https://n8n.myshopify.com,则 Shop Subdomain 为n8n。
- 您的子域名位于 URL 中:
使用 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) 权限的用户账户登录:
- 在 Shopify 中,进入 管理面板(Admin)> 设置(Settings)> 应用和销售渠道(Apps and sales channels)。
- 选择 开发应用(Develop apps)。
- 选择 允许自定义应用开发(Allow custom app development)。
- 阅读提供的警告和信息后,点击 允许自定义应用开发(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 提供支持