兑换商品

POST

/api/v1/exchange-goods/exchange

使用智豆兑换商品。优惠券类型商品兑换后直接发放到优惠券列表；礼品类型商品需要填写收货地址。

请求参数

Header 参数

Body 参数application/json必填

示例

兑换优惠券兑换礼品

{
    "goods_id": 1,
    "goods_type_id": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

兑换优惠券兑换礼品

curl --location --request POST 'https://web.richen8.cn/api/v1/exchange-goods/exchange' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NzgxMjA5NTYsImlhdCI6MTc3NTUyODk1NiwianRpIjoiZjYwZWI0YWMtNDg3NS00MzM4LThkZGUtMGI2ZTFjZjFhOGZhIiwidXNlcl9pZCI6MzF9.hTIJI1W90s0ABGjpIjwLUWAQmSi9-OFh_KvgUotfSP4' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goods_id": 1,
    "goods_type_id": 1
}'

返回响应

🟢200

application/json

兑换成功

Body

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "exchange_id": 1001,
        "goods_name": "1元优惠券",
        "exchange_time": "2025-04-08 00:30:00",
        "cost_amount": 100,
        "remain_balance": 4900,
        "delivery_status": 0,
        "tracking_number": "",
        "receiver_info": "优惠券已发放至您的账户"
    }
}

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

获取兑换商品列表

获取用户兑换记录列表