GET /wallets/coupons

获取优惠券列表

钱包服务 `bearerAuth` application/json

响应

引用的 Schema

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

service-core/base/dto.SimpleResponse

字段类型必填示例约束描述
code integer 否
message string 否
timestamp string 否

service-wallet/internal/handler/dto.CouponListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-wallet/internal/handler/dto.CouponResponse

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-wallet/internal/handler/dto.CouponResponse

优惠券信息

字段类型必填示例约束描述
code string 否 DISCOUNT20 码
created_at string 否 2026-01-01T00:00:00Z 创建
id string 否 cpn_abc123 ID
min_amount string 否 100.00 最低消费
name string 否 20元优惠券 名称
status string 否 unused 状态
type string 否 cash 类型
used_at string 否 使用时间
used_order_id string 否 订单ID
valid_from string 否 2026-01-01T00:00:00Z 生效
valid_until string 否 2026-12-31T23:59:59Z 失效
value string 否 20.00 价值