Appearance
查询用户卡列表
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 以各卡片记录为准。
请求参数：
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
email | string | 条件必填 | 无 | 用户邮箱，和 memberId 二选一，最大 128 个字符。 |
memberId | string | 条件必填 | 无 | 平台成员 ID，和 email 二选一，最大 64 个字符。 |
status | string | 否 | 无 | 外部渠道原始卡状态筛选，值域可能扩展；当前已知值为 active、locked、lost、inactive。 |
page | integer | 否 | 1 | 页码。 |
pageSize | integer | 否 | 20 | 每页数量。 |
响应 data：分页结构，items[] 字段同查询卡详情。