POST 获取当前条件下的可购商品
智简魔方业务系统 V10 地域购物车商品目录接口，根据产品类型、计费方式、区域、可用区和线路查询可购商品。响应包含商品及原生来源标识和配置方式，前台选择完整配置后须调用报价接口，不能直接使用目录中的价格占位值。
接口概览
| 项目 | 内容 |
|---|---|
| 文档类型 | 前台接口 |
| 请求方式 | POST |
| 接口地址 | /console/v1/location_cart/products |
| 所属业务 | 地域购物车 |
| 来源模块/系统 | 地域购物车插件（location_cart） |
| 接口版本 | v2 |
| 认证方式 | 允许游客访问；登录用户可沿用前台 JWT。 |
完整请求
请求
正在加载示例…接口说明
根据产品类型、计费方式、区域、可用区和线路，获取当前条件下可购买的魔方云或 DCIM 商品。
current_price 固定为 null，quote_required 固定为 true。价格必须在选择完整配置后调用报价接口获取。
同一商品可能有多个原生来源。选定商品和来源后，使用对应的 source_key 获取配置、报价和加购。
请求参数
| 名称 | 位置 | 类型 | 必选 | 默认值 | 说明 |
|---|---|---|---|---|---|
category | body | string | 是 | — | 产品类型 cloud=魔方云 dcim=DCIM |
region_key | body | string | 是 | — | 区域稳定标识 |
zone_key | body | string | 是 | — | 可用区稳定标识 |
billing_mode | body | string | 是 | — | 计费方式 recurring_prepayment=包年包月 on_demand=按需计费；DCIM仅允许包年包月 |
line_key | body | string | 是 | — | 线路稳定标识，由地域可用条件接口返回 |
成功响应
以下为结构示例，部分可选或动态字段省略；全部响应字段定义见“响应参数”。
正在加载示例…失败响应
业务状态 400：参数或业务校验失败。提示信息以实际响应中的 msg 为准。
正在加载示例…响应状态
| 业务状态码 | 含义 | 说明 |
|---|---|---|
200 | 请求成功 | 读取 data 继续购买流程。 |
400 | 请求参数或业务校验失败 | 线路不合法，或不再支持当前产品类型、计费方式及地域。 |
上表为 JSON 响应体中的
status，不是 HTTP 状态码。不能仅凭 HTTP 请求成功判断业务是否成功。
响应参数
成功响应与特定业务失败响应中使用的字段如下。字段是否出现取决于响应场景；原文档未声明返回字段的必选属性。
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 状态码 200成功 400失败 |
msg | string | 提示信息 |
data | object | 当前条件下的商品目录 |
data.selection | object | 服务端确认的区域、可用区、计费方式和线路 |
data.products | array | 当前条件下可购买的商品列表 |
data.products[].product_id | integer | V10商品ID |
data.products[].name | string | 商品名称 |
data.products[].description | string | 商品描述 |
data.products[].module | string | 原生模块 mf_cloud或mf_dcim |
data.products[].category | string | 产品类型 cloud或dcim |
data.products[].pay_type | string | 商品付款类型 |
data.products[].cycle | string | 商品周期说明 |
data.products[].quote_required | boolean | 是否必须调用实时报价接口，固定为true |
data.products[].current_price | number | null | 未选择完整配置前不返回价格，固定为null |
data.products[].stock | object | 核心商品库存 |
data.products[].stock.stock_control | integer | 是否启用核心商品库存控制 0否 1是 |
data.products[].stock.available | boolean | 核心商品当前是否有库存 |
data.products[].stock.qty | integer | 核心商品库存数量，未启用库存控制时仅供参考 |
data.products[].source_key | string | 默认原生来源稳定标识，获取配置、报价和加购时必须提交 |
data.products[].data_center_id | integer | 默认原生数据中心ID |
data.products[].line_id | integer | 默认原生线路ID |
data.products[].configuration_available | boolean | 当前来源是否存在可购买配置 |
data.products[].inventory | object | 原生配置库存摘要，available为null表示模块无法提供确定余量 |
data.products[].sources | array | 该商品在当前条件下的全部原生来源 |
data.products[].sources[].source_key | string | 原生来源稳定标识 |
data.products[].sources[].data_center_id | integer | 原生数据中心ID |
data.products[].sources[].line_id | integer | 原生线路ID |
data.products[].sources[].configuration_modes | array | 该来源支持的配置方式 custom自定义 recommend推荐套餐 model=DCIM机型 |
data.count | integer | 商品数量 |