应用代理

应用代理（App Proxy）让你的应用在店铺自己的前台域名下暴露一个路径——例如 https://{shopdomain}.myshoplaza.com/apps/pay——由 Shoplazza 把匹配的请求转发给你的应用后端处理。

为什么用它

没有应用代理时，任何面向店铺前台的接口都只能挂在你自己的域名下：顾客访问时会跳出店铺域名，你也需要自行处理跨域问题。使用应用代理后，请求路径仍留在店铺域名下，由 Shoplazza 透明转发到你的后端。

所需权限

创建和管理应用代理需要 read_app_proxy / write_app_proxy 访问权限。

配置字段

一条应用代理规则有三个可配置字段：

字段	说明
real_path	触发代理的店铺前台路径。例如目标路径是 apps/pay 时，此处填 pay。
proxy_url	处理转发请求的应用 URL，例如 http://www.example.com。
change_origin	是否将转发请求的 Host 头重写为代理目标。

创建一条应用代理

curl -X POST \
  https://{shopdomain}.myshoplaza.com/openapi/2026-07/app-proxies \
  -H 'Content-Type: application/json' \
  -H 'Access-Token: {token}' \
  -d '{
    "real_path": "pay",
    "proxy_url": "http://www.example.com",
    "change_origin": false
  }'

创建完成后，访问 https://{shopdomain}.myshoplaza.com/apps/pay 的请求会被转发到 http://www.example.com。

完整 API 参考

查询列表、创建、查询详情、删除、统计等完整接口，参见 应用代理 API 参考。