POST 获取网络线路
智简魔方业务系统 V10 地域购物车网络线路接口，供前台在选定产品类型、计费方式、部署区域和可用区后读取可用线路。响应包含线路稳定标识、带宽或流量计费类型及商品数量，供后续获取可购商品时原样传递。
接口概览
| 项目 | 内容 |
|---|---|
| 文档类型 | 前台接口 |
| 请求方式 | POST |
| 接口地址 | /console/v1/location_cart/availability |
| 所属业务 | 地域购物车 |
| 来源模块/系统 | 地域购物车插件（location_cart） |
| 接口版本 | v2 |
| 认证方式 | 允许游客访问；登录用户可沿用前台 JWT。 |
完整请求
请求
正在加载示例…接口说明
在产品类型、计费方式、部署区域和可用区已经选定后获取网络线路。
lines[].key 作为获取商品时的 line_key；bill_type 中 bw 表示带宽，flow 表示流量。
请求参数
| 名称 | 位置 | 类型 | 必选 | 默认值 | 说明 |
|---|---|---|---|---|---|
category | body | string | 是 | — | 产品类型 cloud=魔方云 dcim=DCIM |
billing_mode | body | string | 是 | — | 计费方式 recurring_prepayment=包年包月 on_demand=按需计费；DCIM仅允许包年包月 |
region_key | body | string | 是 | — | 区域稳定标识，由部署区域接口返回 |
zone_key | body | string | 是 | — | 可用区稳定标识，由部署区域接口返回 |
成功响应
以下为结构示例，部分可选或动态字段省略；全部响应字段定义见“响应参数”。
正在加载示例…失败响应
业务状态 400：参数或业务校验失败。提示信息以实际响应中的 msg 为准。
正在加载示例…响应状态
| 业务状态码 | 含义 | 说明 |
|---|---|---|
200 | 请求成功 | 读取 data 继续购买流程。 |
400 | 请求参数或业务校验失败 | 地域参数缺失，或所选部署区域、可用区已不可用。 |
上表为 JSON 响应体中的
status，不是 HTTP 状态码。不能仅凭 HTTP 请求成功判断业务是否成功。
响应参数
成功响应与特定业务失败响应中使用的字段如下。字段是否出现取决于响应场景；原文档未声明返回字段的必选属性。
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 状态码 200成功 400失败 |
msg | string | 提示信息 |
data | object | 所选地域下的可用条件 |
data.selection | object | 服务端确认的当前地域选择 |
data.selection.category | string | 产品类型 |
data.selection.billing_mode | string | 规范化后的计费方式 |
data.selection.region_key | string | 区域稳定标识 |
data.selection.zone_key | string | 可用区稳定标识 |
data.lines | array | 支持的网络线路列表 |
data.lines[].key | string | 线路稳定标识，获取商品时作为line_key提交 |
data.lines[].region_key | string | 线路所属区域稳定标识 |
data.lines[].zone_key | string | 线路所属可用区稳定标识 |
data.lines[].name | string | 线路名称 |
data.lines[].bill_type | string | 线路计费类型 bw=带宽 flow=流量 |
data.lines[].product_count | integer | 该线路下可售商品数量 |