**版本：202601**

# 创建应用代理

**POST** `/openapi/2026-01/app-proxies`

创建应用代理，将店铺前台访问路径映射到开发者应用的 URL。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `real_path` string (required)

  访问 Shoplazza 时使用的 URL 路径。例如目标路径为 "apps/pay" 时填写 "pay"
- `proxy_url` string (required)

  开发者应用用于处理请求的 URL，例如 "[http://www.example.com](http://www.example.com)"
- `change_origin` boolean

  是否将请求的 Host 头改写为代理目标地址

```json
{
  "real_path": "string",
  "proxy_url": "string",
  "change_origin": true
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `app_proxy` object

    已创建的应用代理

    - `id` int32

      应用代理的唯一标识
    - `real_path` string

      访问应用代理时配置的 URL 路径。例如目标路径为 "apps/pay" 时填写 "pay"
    - `proxy_url` string

      开发者应用用于处理代理请求的 URL，例如 "[http://www.example.com/app](http://www.example.com/app)"
    - `change_origin` boolean

      是否将请求的 Host 头改写为代理目标地址
    - `created_at` string

      应用代理创建时间
    - `updated_at` string

      应用代理最后更新时间

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "app_proxy": {
      "id": 0,
      "real_path": "string",
      "proxy_url": "string",
      "change_origin": true,
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```