获取兑换商品列表

GET

/api/v1/exchange-goods/list

获取兑换商品列表，支持按类型筛选和分页。优惠券类型商品会额外返回券面值和满减门槛信息。

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://web.richen8.cn/api/v1/exchange-goods/list?exchange_goods_type&page&page_size' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NzgxMjA5NTYsImlhdCI6MTc3NTUyODk1NiwianRpIjoiZjYwZWI0YWMtNDg3NS00MzM4LThkZGUtMGI2ZTFjZjFhOGZhIiwidXNlcl9pZCI6MzF9.hTIJI1W90s0ABGjpIjwLUWAQmSi9-OFh_KvgUotfSP4'

返回响应

🟢200

application/json

成功

Body

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "user_bean_balance": 5000,
        "total": 9,
        "page": 1,
        "page_size": 10,
        "total_page": 1,
        "goods_list": [
            {
                "id": 1,
                "goods_name": "1元优惠券",
                "goods_desc": "满20可用优惠券",
                "goods_type_id": 1,
                "goods_type_name": "优惠券",
                "asset_type_id": 1,
                "asset_type_name": "智慧豆",
                "asset_amount": 100,
                "total_quantity": 9999,
                "remaining_quantity": 9800,
                "is_hot": false,
                "image_url": "",
                "coupon_face_value": 1,
                "coupon_min_order_amount": 20
            },
            {
                "id": 10,
                "goods_name": "精美水杯",
                "goods_desc": "保温水杯",
                "goods_type_id": 2,
                "goods_type_name": "礼品兑换",
                "asset_type_id": 1,
                "asset_type_name": "智慧豆",
                "asset_amount": 5000,
                "total_quantity": 100,
                "remaining_quantity": 50,
                "is_hot": true,
                "image_url": "https://oss.example.com/goods/cup.jpg"
            }
        ]
    }
}

修改于 2026-04-07 17:00:30

获取兑换商品类型列表

兑换商品