创建市场

POST 
/openapi/2026-01/markets

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

请求

application/json

请求体

请求体必填

namestring必填

市场名称，最长 50 个字符，且在店铺内不可重复

countriesstring[]必填

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

confirmboolean

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

示例

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

market object

已创建的市场

idstring

市场 ID

market_namestring

市场名称

is_primaryboolean

是否为主市场

is_defaultboolean

是否为默认市场

market_statusstring

市场状态：active（启用）或 paused（停用）

currencystring

基本货币（ISO 4217）

symbol object

货币符号信息

valstring

符号字符（如 £）

leftstring

置于金额左侧的符号

rightstring

置于金额右侧的符号

cn_namestring

货币中文名

titlestring

货币名称

codestring

货币代码（ISO 4217）

domain_typestring

域名方式：primary 或 sub_path

domain_valuestring

域名值（主域名或子文件夹后缀）

custom_rate_enabledboolean

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

custom_exchange_ratedouble

自定义汇率值。只读

price_adjustint64

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

local_currency_enabledboolean

是否开启本地货币显示

product_tax_includedboolean

商品价格是否已含税

default_languagestring

该市场的默认语言代码（IETF）

countriesstring[]

覆盖的国家（ISO 3166-1 alpha-2）

languages object[]

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

Array [

codestring

IETF 语言代码（如 zh-CN）

namestring

语言显示名称

is_enabledboolean

该语言是否启用

urlstring

该语言在此市场下的店铺访问地址

is_defaultboolean

该语言是否为该市场的默认语言

]

language_manageableboolean

该市场的语言是否可管理

urlstring

该市场的店铺访问地址

created_atstring

创建时间，ISO-8601 格式

updated_atstring

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

actual_ratedouble

实际汇率

exchange_rate object

汇率信息

currencystring

源货币代码（ISO 4217）

to_currencystring

目标货币代码（ISO 4217）

ratedouble

汇率值

last_updated_atstring

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

back_exchange_rate object

反向汇率信息

currencystring

源货币代码（ISO 4217）

to_currencystring

目标货币代码（ISO 4217）

ratedouble

汇率值

last_updated_atstring

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

setting object

市场店铺设置

redirect_enabledboolean

是否启用市场重定向

price_round_enabledboolean

是否启用价格取整

geolocation_app_installedboolean

是否已安装地理位置应用

language_selector_enabledboolean

是否启用语言选择器

delivery_country_limitedboolean

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

示例

{
  "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
    }
  }
}