静态-产品列表
按地区返回库存与各购买天数(30 天及折扣天数)的单价。
鉴权
所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取,并可根据需要重置。详见 通用信息。
接口描述
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 地址 | https://api2.ipmart.io/custom/static/productsV2 |
输入参数
本接口无需请求体,发送空 JSON {} 即可。
重要输出参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| status | 是 | Int | 返回码,200 表示成功 |
| errorMsg | 否 | String | 失败时的错误信息 |
| data | 是 | Array | 静态产品列表(按地区),元素字段见下 |
data 列表元素
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| areaCode | 是 | String | 区域编码 |
| countryCode | 是 | String | 国家编码 |
| cityCode | 是 | String | 城市编码 |
| areaName | 是 | String | 区域名称 |
| countryName | 是 | String | 国家名称 |
| cityName | 是 | String | 城市名称 |
| count | 是 | Int | 该地区可用库存数量(各天数共用) |
| prices | 是 | Array | 各天数价格列表,元素字段见下 |
prices 列表元素
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| days | 是 | Int | 天数;固定包含 30,以及时间折扣表中的其他天数 |
| price | 是 | Number | 该天数单价;30 天取产品价,其他天数 = 30 天价 ×(days/30)× discount;最多保留 2 位小数且向下取整 |
发送示例
json
{}返回示例
成功
json
{
"status": 200,
"errorMsg": null,
"data": [
{
"areaCode": "NA",
"countryCode": "US",
"cityCode": "Random",
"areaName": "北美",
"countryName": "美国",
"cityName": "随机",
"count": 120,
"prices": [
{ "days": 30, "price": 3.5 },
{ "days": 60, "price": 7.0 },
{ "days": 180, "price": 21.0 },
{ "days": 360, "price": 42.0 }
]
}
]
}