**版本：202607**

# 市场

管理店铺的市场：市场全生命周期、域名、定价、含税、状态、默认语言以及商品归属

市场代表商家销售所覆盖的一组国家，拥有独立的货币、定价、域名与语言配置。一个国家只归属一 个市场；主市场受保护：不可删除，且除含税价设置外不可修改。

提供市场的查询列表与详情、创建与更新、域名/定价/含税/状态设置、设置默认语言、删除市场，以 及管理市场销售的商品与市场维度固定价等接口。

- [查询市场列表](/zh-CN/api/markets) `GET /openapi/2026-07/markets`: 查询店铺全部市场及其配置。

- [创建市场](/zh-CN/api/market-create) `POST /openapi/2026-07/markets`: 使用名称与覆盖国家创建市场。

- [查询市场详情](/zh-CN/api/market-detail) `GET /openapi/2026-07/markets/:id`: 查询单个市场的完整详情，含域名、定价、含税、语言与状态。

- [更新市场](/zh-CN/api/market-update) `PUT /openapi/2026-07/markets/:id`: 修改市场名称或覆盖国家。

- [删除市场](/zh-CN/api/market-delete) `DELETE /openapi/2026-07/markets/:id`: 永久删除市场。主市场不可删除；删除不可逆。

- [预览将被删除的市场](/zh-CN/api/market-preview) `POST /openapi/2026-07/markets/preview`: 给定一组国家，预览哪些现有市场会因国家被全部占用而被自动删除。在创建或更新市场前调用，便于调用方获知哪些市场会被移除。

- [修改市场域名](/zh-CN/api/market-domain-update) `PUT /openapi/2026-07/markets/:id/domain`: 修改市场的域名方式（主域名或子文件夹）。

- [修改市场定价](/zh-CN/api/market-price-update) `PUT /openapi/2026-07/markets/:id/price`: 修改市场的基本货币、价格调整与本地货币显示。暂不支持自定义汇率。

- [修改市场含税价](/zh-CN/api/market-tax-update) `PUT /openapi/2026-07/markets/:id/tax`: 修改商品价是否已含税。这是主市场唯一允许的修改操作。

- [启用/停用市场](/zh-CN/api/market-status-update) `PUT /openapi/2026-07/markets/:id/status`: 启用或停用市场。主市场不可停用；停用后客户无法结账。

- [修改市场默认语言](/zh-CN/api/market-default-language-update) `PUT /openapi/2026-07/markets/:id/default-language`: 设置市场的默认语言。该语言须已配置到该市场且已启用。

- [查询市场语言列表](/zh-CN/api/market-languages) `GET /openapi/2026-07/markets/:id/languages`: 查询某市场已配置的语言，含每种语言的启用与默认状态。设置市场默认语言前可先调用本接口。

- [查询市场商品](/zh-CN/api/market-products) `GET /openapi/2026-07/markets/:id/products`: 查询某个市场下的商品，本接口返回每个商品在该市场是否在售，及其按该市场货币计的价格。

- [加入市场商品](/zh-CN/api/market-products-add) `POST /openapi/2026-07/markets/:id/products`: 把商品加入某市场，使该市场销售这些商品。

- [移除市场商品](/zh-CN/api/market-products-delete) `DELETE /openapi/2026-07/markets/:id/products`: 把商品从某市场移除，该市场不再销售这些商品。

- [设置/移除市场商品固定价](/zh-CN/api/market-products-price-update) `PUT /openapi/2026-07/markets/:id/products/price`: 设置或移除某市场下商品的固定价。
