Shopify 凭据

这些凭据可用于以下节点与 Shopify 之间的身份验证。

支持的身份验证方式

Access token（访问令牌，推荐）：用于私有应用或单个商店，普通管理员即可创建。
OAuth2：用于公开应用，必须由合作伙伴账户创建。
API key（API 密钥）：已弃用，请改用访问令牌。

使用访问令牌

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

Shop Subdomain（商店子域名）
Access Token（访问令牌）：创建自定义应用时生成。
APP Secret Key（应用秘密密钥）：创建自定义应用时生成。

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

输入 Shop Subdomain（商店子域名）。
- 子域名位于 URL 中：https://<subdomain>.myshopify.com。例如，完整 URL 为 https://n8n.myshopify.com 时，商店子域名为 n8n。
在 Shopify 中进入 Admin > Settings > Apps and sales channels（管理 > 设置 > 应用与销售渠道）。
选择 Develop apps（开发应用）。
选择 Create a custom app（创建自定义应用）。

未看到此选项？
如果未看到此选项，商店可能尚未启用自定义应用开发。更多信息，请参阅启用自定义应用开发。
在弹窗中输入 App name（应用名称）。
选择 App developer（应用开发者），可以是商店所有者，或具有 Develop apps（开发应用）权限的任意账户。
选择 Create app（创建应用）。
选择 Select scopes（选择作用域）。在 Admin API access scopes（Admin API 访问作用域）部分，为应用选择所需 API 作用域。
- 如需使用 Shopify 节点的全部功能，请添加 read_orders、write_orders、read_products 和 write_products 作用域。
- 可用作用域的更多信息，请参阅 Shopify API 访问作用域。
选择 Save（保存）。
选择 Install app（安装应用）。
在弹窗中选择 Install app（安装应用）。
打开应用的 API Credentials（API 凭据）部分。
复制 Admin API Access Token（Admin API 访问令牌），填入 n8n 凭据的 Access Token（访问令牌）。
复制 API Secret Key（API 秘密密钥），填入 n8n 凭据的 APP Secret Key（应用秘密密钥）。

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

使用 OAuth2

配置此凭据需要一个 Shopify 合作伙伴账户，以及：

Client ID（客户端 ID）：创建自定义应用时生成。
Client Secret（客户端密钥）：创建自定义应用时生成。
Shop Subdomain（商店子域名）

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

信息

自定义应用开发

Shopify 提供创建新应用的模板。以下说明仅涉及设置 n8n 凭据所需的内容。构建应用及使用应用模板的更多信息，请参阅 Shopify 的构建开发文档。

打开 Shopify Partner 控制台。
从左侧导航栏选择 Apps（应用）。
选择 Create app（创建应用）。
在 Use Shopify Partners（使用 Shopify Partners）部分，输入 App name（应用名称）。
选择 Create app（创建应用）。
打开应用详情后，复制 Client ID（客户端 ID），填入 n8n 凭据。
复制 Client Secret（客户端密钥），填入 n8n 凭据。
在左侧菜单选择 Configuration（配置）。
在 n8n 中复制 OAuth Redirect URL（OAuth 重定向 URL），粘贴到 URLs 部分的 Allowed redirection URL(s)（允许的重定向 URL）。
在 URLs 部分，输入应用的 App URL（应用 URL）。此处主机必须与 Allowed redirection URL(s)（允许的重定向 URL）的主机一致，例如使用 n8n 实例的基础 URL。
选择 Save and release（保存并发布）。
从左侧菜单选择 Overview（概览）。此时可选择 Test your app（测试应用），将其安装到自己的某个商店中，或选择 Choose distribution（选择分发方式）公开分发应用。
在 n8n 中输入已安装应用的商店的 Shop Subdomain（商店子域名），无论该应用用于测试还是分发。
- 子域名位于 URL 中：https://<subdomain>.myshopify.com。例如，完整 URL 为 https://n8n.myshopify.com 时，商店子域名为 n8n。

使用 API 密钥

注意

功能可用范围

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

配置此凭据需要：

一个 API Key（API 密钥）
一个 Password（密码）
Shop Subdomain（商店子域名）：子域名位于 URL 中：https://<subdomain>.myshopify.com。例如，完整 URL 为 https://n8n.myshopify.com 时，商店子域名为 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（禁止访问）凭据错误

测试凭据时，如果出现 Couldn't connect with these settings / Forbidden - perhaps check your credentials（无法使用这些设置连接 / 禁止访问，请检查凭据）警告，可能与应用的访问作用域依赖关系有关。例如，read_orders 作用域还需要 read_products。请检查已分配的作用域及要完成的操作。

本文为社区中文翻译。查看对应英文原文

支持的身份验证方式 ​

相关资源 ​

使用访问令牌 ​

使用 OAuth2 ​

使用 API 密钥 ​

常见问题 ​

启用自定义应用开发 ​

Forbidden（禁止访问）凭据错误 ​