Skip to content

静态-产品列表 ​

按地区返回库存与各购买天数(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 }
      ]
    }
  ]
}