如果您正在构建一个 Shopify 应用并想在商店前端展示动态应用内容,您可能会遇到术语 Shopify 应用代理。起初,这听起来像一个普通的 IP 代理,但其实并非如此。Shopify 应用代理是一个开发者功能,它允许 Shopify 将商店请求转发到您的应用后端。
简单来说,它允许客户访问 Shopify 商店的 URL,而实际内容是由您的外部应用生成的。当您的应用需要直接在商店前端展示自定义表单、忠诚度数据、会员内容、产品工具或其他动态特性时,这非常有用。
快速要点
- Shopify 应用代理是 Shopify 应用的一个功能,不是普通的网络代理。
- 它将来自 Shopify URL 的商店请求路由到您的应用后端。
- 它对于由外部应用驱动的动态商店内容非常有用。
- 应用代理请求应该在您的应用返回数据之前进行验证。
- 许多设置问题来自错误的代理路径、后端路由错误或请求验证问题。
什么是 Shopify 应用代理?
Shopify 应用代理允许 Shopify 应用通过商店 URL 提供内容。它不是将用户直接发送到外部域,而是 Shopify 接收商店请求并将其代理到您的应用服务器。
例如,客户可能会访问:
https://store.com/apps/rewards
Shopify 可以将该请求转发至:
https://yourapp.com/proxy/rewards
然后您的应用处理请求并返回内容。对于客户来说,体验仍然感觉像是 Shopify 商店的一部分。
何时使用 Shopify 应用代理?
当您的应用需要在商店前端展示由后端提供的内容时,请使用 Shopify 应用代理。这与在 Shopify 管理员内部运行的嵌入式应用不同。
常见用例包括:
- 显示忠诚度或奖励数据。
- 展示客户特定的会员内容。
- 创建自定义商店表单。
- 将商店页面连接到外部数据库。
- 显示动态产品推荐。
- 通过 Shopify 商店路径提供由应用生成的 HTML 或 JSON。
当您希望商店 URL 保持简洁并属于 Shopify 商店时,尤其有用。
Shopify 应用代理如何工作
这个流程很简单。访问者打开与配置的应用代理路径匹配的商店 URL。Shopify 接收请求,添加代理相关的参数,并将其转发到您配置的应用后端 URL。
您的应用接收请求,验证是否来自 Shopify,处理逻辑,然后返回响应。然后 Shopify 将该响应发送回商店访问者。
重要的一点是验证。您的应用不应盲目信任每个对代理端点的请求。它应该在返回敏感或动态数据之前验证 Shopify 的请求参数。
如何设置 Shopify 应用代理
步骤 1. 打开 Shopify 合作伙伴仪表板
从 Shopify 合作伙伴仪表板开始,而不是主题编辑器。应用代理设置属于应用配置,因此您需要访问您正在构建或维护的应用。
打开您想配置的应用。如果您尚未创建该应用,请先创建,并确保您的后端准备好接收请求。
步骤 2. 找到应用代理设置
在应用配置区域内,查找应用代理或扩展设置。Shopify 的界面可能会随着时间而变化,因此确切位置可能会有所不同。如果找不到,请查看当前的 Shopify 开发者文档或应用配置部分。
您要寻找的是可以定义商店路径和外部应用 URL 的区域。
步骤 3. 配置代理路径
您需要定义代理在商店前端出现的位置,以及 Shopify 应该转发请求的位置。
一个典型设置包括:


