**版本：202601**

# 创建市场

**POST** `/openapi/2026-01/markets`

使用名称与覆盖国家创建市场。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `name` string (required)

  市场名称，最长 50 个字符，且在店铺内不可重复
- `countries` string[] (required)

  覆盖的国家，ISO 3166-1 alpha-2 大写代码（如 US、JP）。一个国家只能归属一个市场
- `confirm` boolean

  确认标志。为 false（默认）且存在国家被其它市场占用时，请求被拒绝并返回将被删除的市场列表；带 true 重试即执行，被占用的那些市场会被自动删除

```json
{
  "name": "string",
  "countries": [
    "string"
  ],
  "confirm": true
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `market` object

    已创建的市场

    - `id` string

      市场 ID
    - `market_name` string

      市场名称
    - `is_primary` boolean

      是否为主市场
    - `is_default` boolean

      是否为默认市场
    - `market_status` string

      市场状态：active（启用）或 paused（停用）
    - `currency` string

      基本货币（ISO 4217）
    - `symbol` object

      货币符号信息

      - `val` string

        符号字符（如 £）
      - `left` string

        置于金额左侧的符号
      - `right` string

        置于金额右侧的符号
      - `cn_name` string

        货币中文名
      - `title` string

        货币名称
      - `code` string

        货币代码（ISO 4217）
    - `domain_type` string

      域名方式：primary 或 sub\_path
    - `domain_value` string

      域名值（主域名或子文件夹后缀）
    - `custom_rate_enabled` boolean

      是否启用自定义汇率。只读，无法通过改定价接口修改
    - `custom_exchange_rate` double

      自定义汇率值。只读
    - `price_adjust` int64

      价格调整百分比，范围 -99 ~ 999
    - `local_currency_enabled` boolean

      是否开启本地货币显示
    - `product_tax_included` boolean

      商品价格是否已含税
    - `default_language` string

      该市场的默认语言代码（IETF）
    - `countries` string[]

      覆盖的国家（ISO 3166-1 alpha-2）
    - `languages` object[]

      配置在该市场上的语言列表

      *   Array \[

      - `code` string

        IETF 语言代码（如 zh-CN）
      - `name` string

        语言显示名称
      - `is_enabled` boolean

        该语言是否启用
      - `url` string

        该语言在此市场下的店铺访问地址
      - `is_default` boolean

        该语言是否为该市场的默认语言
      *   \]
    - `language_manageable` boolean

      该市场的语言是否可管理
    - `url` string

      该市场的店铺访问地址
    - `created_at` string

      创建时间，ISO-8601 格式
    - `updated_at` string

      最后更新时间，ISO-8601 格式
    - `actual_rate` double

      实际汇率
    - `exchange_rate` object

      汇率信息

      - `currency` string

        源货币代码（ISO 4217）
      - `to_currency` string

        目标货币代码（ISO 4217）
      - `rate` double

        汇率值
      - `last_updated_at` string

        汇率最后更新时间，ISO-8601 格式
    - `back_exchange_rate` object

      反向汇率信息

      - `currency` string

        源货币代码（ISO 4217）
      - `to_currency` string

        目标货币代码（ISO 4217）
      - `rate` double

        汇率值
      - `last_updated_at` string

        汇率最后更新时间，ISO-8601 格式
    - `setting` object

      市场店铺设置

      - `redirect_enabled` boolean

        是否启用市场重定向
      - `price_round_enabled` boolean

        是否启用价格取整
      - `geolocation_app_installed` boolean

        是否已安装地理位置应用
      - `language_selector_enabled` boolean

        是否启用语言选择器
    - `delivery_country_limited` boolean

      该市场是否限制了配送国家

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "market": {
      "id": "string",
      "market_name": "string",
      "is_primary": true,
      "is_default": true,
      "market_status": "string",
      "currency": "string",
      "symbol": {
        "val": "string",
        "left": "string",
        "right": "string",
        "cn_name": "string",
        "title": "string",
        "code": "string"
      },
      "domain_type": "string",
      "domain_value": "string",
      "custom_rate_enabled": true,
      "custom_exchange_rate": 0,
      "price_adjust": 0,
      "local_currency_enabled": true,
      "product_tax_included": true,
      "default_language": "string",
      "countries": [
        "string"
      ],
      "languages": [
        {
          "code": "string",
          "name": "string",
          "is_enabled": true,
          "url": "string",
          "is_default": true
        }
      ],
      "language_manageable": true,
      "url": "string",
      "created_at": "string",
      "updated_at": "string",
      "actual_rate": 0,
      "exchange_rate": {
        "currency": "string",
        "to_currency": "string",
        "rate": 0,
        "last_updated_at": "string"
      },
      "back_exchange_rate": {
        "currency": "string",
        "to_currency": "string",
        "rate": 0,
        "last_updated_at": "string"
      },
      "setting": {
        "redirect_enabled": true,
        "price_round_enabled": true,
        "geolocation_app_installed": true,
        "language_selector_enabled": true
      },
      "delivery_country_limited": true
    }
  }
}
```