跳转到内容

查询用户卡列表 ​

GET /openapi/v1/cards/list
项内容
请求方法GET
请求路径/openapi/v1/cards/list
请求类型query

用户标识支持以下两种调用方式,email 和 memberId 必须且只能传一个:

http
GET /openapi/v1/cards/list?email=merchant@example.com
GET /openapi/v1/cards/list?memberId=member_001

两种方式都会返回该用户关联的卡列表,响应中的 memberId 以各卡片记录为准。

请求参数:

字段类型必填默认值说明
emailstring条件必填无用户邮箱,和 memberId 二选一,最大 128 个字符。
memberIdstring条件必填无平台成员 ID,和 email 二选一,最大 64 个字符。
statusstring否无外部渠道原始卡状态筛选,值域可能扩展;当前已知值为 active、locked、lost、inactive。
pageinteger否1页码。
pageSizeinteger否20每页数量。

响应 data:分页结构,items[] 字段同查询卡详情。