接口说明

获取商品列表,同一IP的访问频率限制为:120次 / 60秒,如果需要实时同步商品信息,请使用平台提供的 商品信息订阅 功能进行实现。

接口地址

/api/product-list

传入参数

仅传入接口约定参数即可

返回数据

参数名 类型 说明
id int 商品编号
product_name string 商品名称
name string 规格名称
price decimal 售价
valid_purchasing_quantity string 合法的购买数量
type int 商品类型(1:充值,2:卡密,3:卡券,4:人工)
stock_state int 库存状态(1:充足,2:断货)
supply_state int 状态(1:上架,2:维护,3:下架)
hold_state int 供货状态 (1.允许采购,2.限制采购)
ban_start_at string 禁售开始时间(详见下方说明)
ban_end_at string 禁售结束时间(详见下方说明)

禁售字段说明

1.空字符串表示无禁售策略;

2.禁售时段可能在同一天,也有可能在连续两天,所以不能简单利用开始时间和结束时间的大小做范围判断。比如从头一天的 23:00:00 到第二天凌晨 06:00:00,对应字段如下:ban_start_at=23:00:00,ban_end_at=06:00:00,此时如果按照时间大小做范围判断就会出错。

示例
{
    "code": "ok",
    "message": "",
    "data":[
         {
            "id": 1886,
            "product_name":"爱奇艺视频会员",
            "name": "月卡",
            "price": "0.6",
            "valid_purchasing_quantity": "1-10000",
            "type": 1,
            "stock_state": 1,
            "supply_state": 1,
            "ban_start_at":"14:00:00"
            "ban_end_at":"16:59:59"
        }
    ]
}