GET `/wallets/coupons`

获取优惠券列表

钱包服务 `bearerAuth` application/json

Responses

Status	Description	Schema
200	OK	`dto.CouponListResponse`
400	请求参数错误	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	未认证或令牌无效	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	服务内部错误	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.CouponListResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`items`	array of See `dto.CouponResponse`	No			统一使用 items
`message`	`string`	No
`pagination`	`object`	No			分页信息（嵌套对象）
`timestamp`	`string`	No
`total`	`integer`	No			总条数（平铺，便于直接读取）

dto.CouponResponse

优惠券信息

Field	Type	Required	Example	Constraints	Description
`code`	`string`	No	`DISCOUNT20`		码
`created_at`	`string`	No	`2026-01-01T00:00:00Z`		创建
`id`	`string`	No	`cpn_abc123`		ID
`min_amount`	`string`	No	`100.00`		最低消费
`name`	`string`	No	`20元优惠券`		名称
`status`	`string`	No	`unused`		状态
`type`	`string`	No	`cash`		类型
`used_at`	`string`	No			使用时间
`used_order_id`	`string`	No			订单ID
`valid_from`	`string`	No	`2026-01-01T00:00:00Z`		生效
`valid_until`	`string`	No	`2026-12-31T23:59:59Z`		失效
`value`	`string`	No	`20.00`		价值

gitee_com_linmes_authms_base_dto.PageInfo

Field	Type	Required	Example	Constraints	Description
`has_next`	`boolean`	No			HasNext indicates whether there is a next page
`has_prev`	`boolean`	No			HasPrev indicates whether there is a previous page
`page`	`integer`	No			Page is the current page number (1-based)
`page_size`	`integer`	No			PageSize is the number of items per page
`total`	`integer`	No			Total is the total number of items across all pages
`total_pages`	`integer`	No			TotalPages is the total number of pages

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑