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 凭证 部分。
- 复制 管理员 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
范围。请检查您已分配的范围和尝试执行的操作。