# 应用代理概览

> 应用代理（App Proxy）让 Shoplazza 应用在店铺前台域名下暴露路径：适用场景、所需权限、配置字段与创建步骤。

# 应用代理

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

## 为什么用它

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

## 所需权限

创建和管理应用代理需要 `read_app_proxy` / `write_app_proxy` [访问权限](/docs/app/building-blocks/authentication/access-scopes)。

## 配置字段

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

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

## 创建一条应用代理

```bash
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 参考](/api/app-proxy/)。