客户运营能力-查询储值卡列表:URI
URI
GET /v2/promotions/benefits/stored-value-cards
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
status |
是 |
Integer |
[1-2] |
状态: 1:可使用 2:已用完 |
card_id |
否 |
String |
最大长度:64 |
储值卡ID。 此参数不携带或携带值为空时,不作为筛选条件。 |
offset |
否 |
Integer |
[0-最大整数] |
偏移量,从0开始。默认值为0。
说明:
offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。 示例1,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。 示例2,查询总数20条,期望每页返回10条数据,则获取第一页数据,入参offset填写0,limit填写10;获取第二页数据,入参offset填写10,limit填写10。 |
limit |
否 |
Integer |
[1-100] |
查询的储值卡的数量,默认值为10。 |