outsource/HaniBlindBox

Fork 0

zpc ab57d29f65 api 迁移

2026-01-03 12:44:56 +08:00

59 KiB

Raw Blame History

抽奖盲盒系统API接口文档

1. 接口概览

基础信息

基础URL: https://api.zfunbox.cn/api/
API版本: v1
数据格式: JSON
字符编码: UTF-8
认证方式: Token认证
签名方式: MD5签名 + 时间戳防重放

通用响应格式

{
    "status": 1,
    "msg": "success",
    "data": {},
    "timestamp": 1640995200
}

状态码说明

状态码	说明
1	请求成功
0	请求失败
-1	未登录
-9	需要绑定手机号
2222	特殊状态（如已领取等）

请求签名机制

所有POST请求都需要包含以下参数：

timestamp: 当前时间戳
nonce: 随机字符串
sign: MD5签名

签名算法：

将所有参数按键名排序
拼接为 key1=value1&key2=value2 格式
添加密钥：host + timestamp
对整个字符串进行MD5加密

2. 用户认证接口

2.1 发送短信验证码

POST /v2/account/sendSms

请求参数:

{
    "phone": "13800138000"
}

参数说明:

参数	类型	必填	说明
phone	string	是	手机号

响应示例:

{
    "status": 1,
    "msg": "验证码发送成功",
    "data": 60
}

2.2 手机号登录

POST /mobileLogin

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/mobileLogin

请求参数:

{
    "mobile": "13800138000",
    "code": "123456",
    "pid": 0,
    "clickId": ""
}

参数说明:

参数	类型	必填	说明
mobile	string	是	手机号
code	string	是	验证码
pid	int	否	推荐人ID
clickId	string	否	点击ID

响应示例:

{
    "status": 1,
    "msg": "登录成功",
    "data": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

2.3 微信授权登录

POST /login

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/login

请求参数:

{
    "code": "wx_auth_code",
    "pid": 0,
    "clickId": ""
}

参数说明:

参数	类型	必填	说明
code	string	是	微信授权code
pid	int	否	推荐人ID
clickId	string	否	点击ID

响应示例:

{
    "status": 1,
    "msg": "登录成功",
    "data": "token_string"
}

2.4 获取用户信息

POST /user

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/user

请求头:

Authorization: Bearer {token}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "userinfo": {
            "id": 1001,
            "phone": "138****8000",
            "nickname": "用户昵称",
            "avatar": "头像URL",
            "money": "100.00",
            "integral": "50.00",
            "money2": "20.00",
            "level": 1,
            "mobile_is": 1
        }
    }
}

2.5 更新用户信息

POST /update_userinfo

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/update_userinfo

请求头:

Authorization: Bearer {token}

请求参数:

{
    "nickname": "新昵称",
    "headimg": "头像URL",
    "imagebase": "Base64编码的图片数据"
}

参数说明:

参数	类型	必填	说明
nickname	string	否	新昵称
headimg	string	否	头像URL（直接使用URL）
imagebase	string	否	Base64编码的图片数据（优先使用）

响应示例:

{
    "status": 1,
    "msg": "更新成功"
}

2.6 注销账号

POST /user_log_off

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/user_log_off

请求头:

Authorization: Bearer {token}

请求参数:

{
    "type": 0
}

参数说明:

参数	类型	必填	说明
type	int	否	类型：0-注销账号，1-取消注销

响应示例:

{
    "status": 1,
    "msg": "注销成功"
}

2.6 微信授权绑定手机号

POST /login_bind_mobile

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/login_bind_mobile

请求头:

Authorization: Bearer {token}

请求参数:

{
    "code": "wx_phone_auth_code"
}

参数说明:

参数	类型	必填	说明
code	string	是	微信获取手机号授权code

响应示例:

{
    "status": 1,
    "msg": "绑定成功",
    "data": {
        "token": "new_token_if_account_merged"
    }
}

说明:

如果手机号已被其他用户绑定，会进行账户合并，返回新的token
如果手机号未被绑定，直接绑定到当前用户，token为null

2.7 验证码绑定手机号

POST /bindMobile

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/bindMobile

请求头:

Authorization: Bearer {token}

请求参数:

{
    "mobile": "13800138000",
    "code": "123456"
}

参数说明:

参数	类型	必填	说明
mobile	string	是	手机号
code	string	是	短信验证码

响应示例:

{
    "status": 1,
    "msg": "绑定成功",
    "data": {
        "token": "new_token_if_account_merged"
    }
}

说明:

如果手机号已被其他用户绑定，会进行账户合并，返回新的token
如果手机号未被绑定，直接绑定到当前用户，token为null

2.8 记录用户登录

GET|POST /login_record

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: GET|POST /api/login_record

请求头:

Authorization: Bearer {token}

请求参数:

{
    "device": "android",
    "deviceInfo": "设备信息"
}

参数说明:

参数	类型	必填	说明
device	string	否	设备类型
deviceInfo	string	否	设备信息

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "uid": "100001",
        "nickname": "用户昵称",
        "headimg": "头像URL"
    }
}
}

3. 商品相关接口

3.1 获取首页商品列表

POST /goods

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_list

请求参数:

{
    "page": 1,
    "type": 0,
    "keyword": ""
}

参数说明:

参数	类型	必填	说明
page	int	是	页码，从1开始
type	int	否	商品类型：0-全部，1-一番赏，2-无限赏等
keyword	string	否	搜索关键词

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "data": [
            {
                "id": 1001,
                "title": "精美手办盲盒",
                "imgurl": "商品图片URL",
                "price": "29.90",
                "type": 1,
                "stock": 100,
                "sale_stock": 50,
                "status": 1,
                "prize_num": 1,
                "show_price": "29.9元/抽"
            }
        ],
        "total": 100,
        "current_page": 1,
        "last_page": 10
    }
}

3.2 获取商品详情（一番赏）

POST /goodsdetail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_detail

请求参数:

{
    "goods_id": 1001,
    "num": 0
}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "goods": {
            "id": 1001,
            "title": "精美手办盲盒",
            "imgurl": "商品封面图",
            "imgurl_detail": "商品详情图",
            "price": "29.90",
            "type": 1,
            "stock": 100,
            "prize_num": 1,
            "goods_describe": "商品描述"
        },
        "goods_list": [
            {
                "id": 2001,
                "title": "限定手办A",
                "imgurl": "奖品图片",
                "price": "299.00",
                "money": "150.00",
                "real_pro": "0.05000",
                "goods_type": 1,
                "prize_code": "A001"
            }
        ]
    }
}

3.3 获取商品子奖品

POST /goods_children

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_children

请求参数:

{
    "goods_id": 1001,
    "goods_num": 0,
    "goods_list_id": 2001
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
goods_num	int	否	箱号，默认0
goods_list_id	int	是	奖品ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "id": 3001,
            "title": "子奖品名称",
            "imgurl": "子奖品图片",
            "price": "99.00",
            "real_pro": "0.05000",
            "shang_info": {
                "id": 1,
                "title": "A赏",
                "color": "#FF0000"
            }
        }
    ]
}

3.4 获取商品扩展配置

POST /goods_extend

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_extend

请求参数:

{
    "goods_id": 1001,
    "goods_type": 1
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
goods_type	int	否	商品类型

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "pay_wechat": 1,
        "pay_balance": 1,
        "pay_currency": 1,
        "pay_currency2": 1,
        "dk_money": 1,
        "dk_integral": 1,
        "dk_money2": 1
    }
}

3.5 获取箱号列表

POST /goods_num_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_num_list

请求参数:

{
    "goods_id": 1001
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "start": 1,
            "end": 10,
            "text": "1-10"
        },
        {
            "start": 11,
            "end": 20,
            "text": "11-20"
        }
    ]
}

3.6 获取箱号详情

POST /goods_num_detail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_num_detail

请求参数:

{
    "goods_id": 1001,
    "page_no": 0,
    "sort": 0
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
page_no	int	否	页码，默认0（第一组）
sort	int	否	排序：0-箱号升序，1-箱号降序，2-余量降序

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "num": 1,
            "surplus_all_stock": 50,
            "goods_list": [
                {
                    "id": 2001,
                    "title": "奖品名称",
                    "imgurl": "奖品图片",
                    "surplus_stock": 5
                }
            ]
        }
    ]
}

3.7 获取无限赏商品详情

POST /infinite_goodsdetail

请求参数:

{
    "goods_id": 1001
}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "goods": {
            "id": 1001,
            "title": "无限赏盲盒",
            "imgurl": "商品图片",
            "price": "19.90",
            "type": 2,
            "lingzhu_is": 1,
            "king_user_id": 1234
        },
        "goods_list": [
            {
                "id": 2001,
                "title": "稀有奖品",
                "imgurl": "奖品图片",
                "price": "199.00",
                "real_pro": "0.01000"
            }
        ]
    }
}

3.4 获取商品奖品数量统计

POST /goodslist_count

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_prize_count

请求参数:

{
    "goods_id": 1001
}

3.5 获取商品奖品内容

POST /goodslist_content

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_prize_content

请求参数:

{
    "goods_id": 1001,
    "num": 0
}

3.6 获取预售日历

POST /yushourili

请求参数:

{
    "page": 1
}

4. 订单相关接口

4.1 计算订单金额（一番赏）

POST /ordermoney

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/ordermoney

请求参数:

{
    "goods_id": 1001,
    "num": 0,
    "prize_num": 1,
    "coupon_id": "",
    "use_money_is": 2,
    "use_integral_is": 2,
    "use_money2_is": 2
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
num	int	是	第几套
prize_num	int	是	抽奖数量
coupon_id	string	否	优惠券ID
use_money_is	int	否	是否使用余额：1-是，2-否
use_integral_is	int	否	是否使用积分：1-是，2-否
use_money2_is	int	否	是否使用哈尼券：1-是，2-否

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "order_total": "29.90",
        "price": "29.90",
        "goods_info": {
            "id": 1001,
            "title": "精美手办盲盒",
            "imgurl": "商品图片"
        },
        "goodsExtend": {
            "pay_wechat": 1,
            "pay_balance": 1,
            "pay_currency": 1,
            "pay_currency2": 1
        }
    }
}

4.2 创建订单并支付（一番赏）

POST /orderbuy

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/orderbuy

请求参数:

{
    "goods_id": 1001,
    "num": 0,
    "prize_num": 1,
    "coupon_id": "",
    "use_money_is": 2,
    "use_integral_is": 2,
    "use_money2_is": 2
}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "status": 1,
        "order_num": "202401010001",
        "res": {
            "appId": "wx123456789",
            "timeStamp": "1640995200",
            "nonceStr": "abc123",
            "package": "prepay_id=wx123456789",
            "signType": "RSA",
            "paySign": "signature"
        }
    }
}

4.3 无限赏订单金额计算

POST /infinite_ordermoney

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/infinite_ordermoney

请求参数:

{
    "goods_id": 1001,
    "prize_num": 1,
    "use_money_is": 2,
    "use_integral_is": 2,
    "use_money2_is": 2,
    "coupon_id": ""
}

4.4 无限赏创建订单

POST /infinite_orderbuy

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/infinite_orderbuy

请求参数:

{
    "goods_id": 1001,
    "prize_num": 1,
    "use_money_is": 2,
    "use_integral_is": 2,
    "use_money2_is": 2,
    "coupon_id": ""
}

4.5 商城订单金额计算

POST /mall_ordermoney

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/mall_ordermoney

请求参数:

{
    "goods_id": 1001,
    "prize_num": 1,
    "goods_num": 1,
    "use_money_is": 2,
    "use_integral_is": 2,
    "use_money2_is": 2
}

4.6 获取订单列表

POST /order_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/order_list

请求参数:

{
    "page": 1,
    "page_size": 20
}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "data": [
            {
                "id": 10001,
                "order_num": "202401010001",
                "goods_title": "精美手办盲盒",
                "goods_imgurl": "商品图片",
                "order_total": "29.90",
                "price": "29.90",
                "prize_num": 1,
                "status": 1,
                "addtime": 1640995200,
                "pay_time": 1640995300
            }
        ],
        "total": 50,
        "current_page": 1,
        "last_page": 3
    }
}

4.7 获取订单详情

POST /order_detail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/order_detail

请求参数:

{
    "order_num": "202401010001"
}

5. 抽奖相关接口

5.1 获取抽奖结果（一番赏）

POST /prizeorderlog

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/prizeorderlog

请求参数:

{
    "order_num": "202401010001"
}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "id": 20001,
            "order_id": 10001,
            "goodslist_title": "限定手办A",
            "goodslist_imgurl": "奖品图片",
            "goodslist_price": "299.00",
            "goodslist_money": "150.00",
            "goodslist_type": 1,
            "status": 0,
            "addtime": 1640995300,
            "prize_code": "A001",
            "luck_no": 1
        }
    ]
}

5.2 获取无限赏抽奖结果

POST /infinite_prizeorderlog

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/infinite_prizeorderlog

请求参数:

{
    "order_num": "202401010001"
}

5.3 获取中奖记录

POST /shang_log

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/goods_prize_logs

请求参数:

{
    "goods_id": 1001,
    "goods_num": 0,
    "shang_id": 0,
    "page": 1,
    "page_size": 15
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
goods_num	int	否	箱号，默认0
shang_id	int	否	赏品分类ID，0=全部
page	int	否	页码，默认1
page_size	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "category": [
            {
                "id": 1,
                "title": "A赏",
                "color": "#FF0000"
            }
        ],
        "data": [
            {
                "user_nickname": "用户***",
                "user_headimg": "头像URL",
                "goodslist_title": "限定手办A",
                "goodslist_imgurl": "奖品图片",
                "shang_info": {
                    "id": 1,
                    "title": "A赏",
                    "color": "#FF0000"
                },
                "addtime": "2024-01-01 10:30:00",
                "luck_no": 1
            }
        ],
        "last_page": 10
    }
}

5.4 获取无限赏中奖记录

POST /infinite_shang_log

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/infinite_shang_log

请求参数:

{
    "goods_id": 1001,
    "shang_id": 0,
    "is_mibao": 0,
    "page": 1,
    "page_size": 100
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
shang_id	int	否	赏品等级ID，0表示全部
is_mibao	int	否	是否秘宝池，0=否，1=是
page	int	否	页码，默认1
page_size	int	否	每页数量，默认100

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "category": [
            {"shang_id": 0, "shang_title": "全部"},
            {"shang_id": 34, "shang_title": "A赏"}
        ],
        "data": [
            {
                "id": 1,
                "user_id": 100,
                "goodslist_title": "奖品名称",
                "goodslist_imgurl": "https://example.com/image.jpg",
                "shang_id": 34,
                "shang_title": "A赏",
                "shang_color": "#FF0000",
                "addtime": "2025-01-03 10:30:00",
                "luck_no": 1,
                "doubling": 1,
                "is_lingzhu": 0,
                "user_info": {
                    "nickname": "用***户",
                    "headimg": "https://example.com/avatar.jpg"
                }
            }
        ],
        "last_page": 10,
        "total": 100
    }
}

5.5 获取用户抽奖记录（盒子抽奖记录）

POST /infinite_prizerecords

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/infinite_prizerecords

请求参数:

{
    "goods_id": 1001,
    "page": 1,
    "page_size": 100
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
page	int	否	页码，默认1
page_size	int	否	每页数量，默认100

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "data": [
            {
                "user_id": 10001,
                "goodslist_title": "限定手办A",
                "goodslist_imgurl": "https://example.com/prize.jpg",
                "addtime": "2025-01-03 10:30:00"
            }
        ],
        "current_page": 1,
        "last_page": 1,
        "per_page": 100,
        "total": 1
    }
}

5.6 使用道具卡抽奖

POST /item_card_chou

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/item_card_chou

请求参数:

{
    "goods_id": 1001,
    "order_list_ids": "1,2,3"
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
order_list_ids	string	是	要重抽的订单项ID列表（逗号分隔）

响应示例:

{
    "status": 1,
    "msg": "重抽成功",
    "data": {
        "status": 0,
        "order_num": "MH_20260103120000001234",
        "prizes": [
            {
                "id": 10001,
                "title": "限定手办A",
                "img_url": "奖品图片",
                "shang_id": 34,
                "shang_title": "A赏",
                "shang_color": "#FF0000",
                "price": "299.00",
                "sc_money": "150.00",
                "prize_code": "P202601031200001234",
                "luck_no": 1
            }
        ],
        "remaining_cards": 2
    }
}

6. 盒柜（仓库）相关接口

6.1 获取仓库首页

POST /warehouse_index

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_index

请求参数:

{
    "page": 1,
    "status": 0
}

参数说明:

参数	类型	必填	说明
page	int	是	页码
status	int	否	状态：0-待选择，1-回收，2-发货，3-集市

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "data": [
            {
                "id": 20001,
                "goodslist_title": "限定手办A",
                "goodslist_imgurl": "奖品图片",
                "goodslist_price": "299.00",
                "goodslist_money": "150.00",
                "status": 0,
                "addtime": 1640995300
            }
        ]
    }
}

6.2 回收奖品

POST /warehouse_recovery

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_recovery

请求参数:

{
    "order_list_ids": "20001,20002"
}

6.3 发货奖品

POST /warehouse_send

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_send

请求参数:

{
    "order_list_ids": "20001,20002",
    "name": "张三",
    "mobile": "13800138000",
    "address": "北京市朝阳区xxx街道xxx号",
    "message": "请小心轻放"
}

6.4 确认发货

POST /warehouse_send_confirm

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_send_confirm

请求参数:

{
    "id": 70001
}

6.5 获取发货记录

POST /warehouse_send_record

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_send_record

请求参数:

{
    "page": 1
}

6.6 获取发货记录详情

POST /warehouse_send_record_detail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_send_record_detail

请求参数:

{
    "id": 70001
}

6.7 获取回收记录

POST /warehouse_recovery_record

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_recovery_record

请求参数:

{
    "page": 1
}

6.8 获取物流信息

POST /warehouse_order_logistics

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/warehouse_order_logistics

请求参数:

{
    "id": 70001
}

7. 财务相关接口

7.1 获取资金明细

POST /profitMoney

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/profitMoney

请求参数:

{
    "page": 1,
    "type": 0
}

参数说明:

参数	类型	必填	说明
page	int	是	页码
type	int	否	类型：0-全部，1-收入，2-支出，3-提现

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "changeMoney": "+150.00",
                "content": "背包回收",
                "addTime": "2024-01-01 10:30:00"
            }
        ],
        "lastPage": 10,
        "currentPage": 1,
        "total": 100
    }
}

7.2 获取吧唧币明细

POST /profitIntegral

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/profitIntegral

请求参数:

{
    "page": 1,
    "type": 0
}

参数说明:

参数	类型	必填	说明
page	int	是	页码
type	int	否	类型：0-全部，1-收入，2-支出

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "changeMoney": "+50.00",
                "content": "任务奖励",
                "addTime": "2024-01-01 10:30:00"
            }
        ],
        "lastPage": 5,
        "currentPage": 1,
        "total": 50
    }
}

7.3 获取积分明细

POST /profitScore

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/profitScore

请求参数:

{
    "page": 1,
    "type": 0
}

参数说明:

参数	类型	必填	说明
page	int	是	页码
type	int	否	类型：0-全部，1-收入，2-支出

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "changeMoney": "+20.00",
                "content": "签到奖励",
                "addTime": "2024-01-01 10:30:00"
            }
        ],
        "lastPage": 3,
        "currentPage": 1,
        "total": 30
    }
}

7.4 获取支付明细

POST /profitPay

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/profitPay

请求参数:

{
    "page": 1
}

参数说明:

参数	类型	必填	说明
page	int	是	页码

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "changeMoney": "-29.90",
                "content": "购买商品",
                "addTime": "2024-01-01 10:30:00"
            }
        ],
        "lastPage": 5,
        "currentPage": 1,
        "total": 50
    }
}

7.4 获取优惠券列表

POST /coupon_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_list

请求参数:

{
    "page": 1,
    "status": 1,
    "limit": 15
}

参数说明:

参数	类型	必填	说明
page	int	是	页码
status	int	否	状态：1-未使用，2-已分享
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "id": 60001,
                "status": 1,
                "level": 3,
                "levelText": "高级赏券",
                "levelImg": "/storage/coupon/coupon_c.png",
                "title": "高级赏券",
                "num": "500",
                "klNum": 6,
                "klNum2": 6,
                "yiLing": 0
            }
        ],
        "lastPage": 10,
        "yCount": 5,
        "zCount": 50,
        "userIntegral": 1000.00,
        "keHcCount": 20,
        "sunHao": "10%"
    }
}

7.4.1 获取优惠券详情

POST /coupon_detail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_detail

请求参数:

{
    "id": 60001
}

参数说明:

参数	类型	必填	说明
id	int	是	优惠券ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "id": 60001,
        "level": 3,
        "levelText": "高级赏券",
        "levelImg": "/storage/coupon/coupon_c.png",
        "shareTime": "2024-01-01 10:30:00",
        "userId": 1001,
        "num": "500",
        "klNum2": 6,
        "own2": 100.00,
        "ylCount": 3,
        "ylIntegralCount": 150.00,
        "shareUserNickname": "用户昵称",
        "shareUserHeadimg": "头像URL",
        "ylList": [
            {
                "userId": 1002,
                "nickname": "领取者昵称",
                "headimg": "头像URL",
                "lNum": 50.00,
                "addTime": "2024-01-01 11:00:00",
                "luckyKing": 1
            }
        ]
    }
}

7.5 领取优惠券

POST /coupon_ling

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_ling

请求参数:

{
    "id": 60001
}

参数说明:

参数	类型	必填	说明
id	int	是	优惠券ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "amount": 50.00,
        "luckyKing": false
    }
}

错误码说明:

错误码	说明
2222	请勿开启自己的劵 / 你已经领取过了 / 来晚了, 已经被人领完了
0	每天最多领取N次

7.6 分享优惠券

POST /coupon_share

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_share

请求参数:

{
    "id": 60001
}

参数说明:

参数	类型	必填	说明
id	int	是	优惠券ID

响应示例:

{
    "status": 1,
    "msg": "分享成功"
}

7.7 合成优惠券

POST /coupon_synthesis

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_synthesis

请求参数:

{
    "couponIds": "60001,60002,60003"
}

参数说明:

参数	类型	必填	说明
couponIds	string	是	优惠券ID列表，逗号分隔，最多20个

响应示例:

{
    "status": 1,
    "msg": "合成成功"
}

错误说明:

特级、终极赏券不能合成
最多只能20个合成

7.8 计算优惠券合成

POST /coupon_ji_suan

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/coupon_ji_suan

请求参数:

{
    "couponIds": "60001,60002,60003"
}

参数说明:

参数	类型	必填	说明
couponIds	string	是	优惠券ID列表，逗号分隔，最多20个

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "coupon": {
            "title": "高级赏券",
            "level": 3
        },
        "sumNum": 1000.00,
        "shNum": 900.00
    }
}

说明:

sumNum: 原始总价值
shNum: 合成后价值（扣除10%损耗）

8. 福利相关接口

8.1 获取福利屋列表

POST /welfare_house_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/welfare_house_list

请求头:

Authorization: Bearer {token}

请求参数:

{
    "type": 1,
    "page": 1,
    "limit": 15
}

参数说明:

参数	类型	必填	说明
type	int	否	类型：1-进行中，3-已结束，默认1
page	int	否	页码，默认1
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "list": [
            {
                "id": 1001,
                "title": "每日福利",
                "imgurl": "福利图片",
                "price": 0.00,
                "type": 15,
                "newIs": 0,
                "quanjuXiangou": 0,
                "choujiangXianzhi": 0,
                "goodsDescribe": "福利描述",
                "isOpen": 0,
                "unlockAmount": 0.00,
                "joinCount": 100,
                "flwStartTime": "2024-01-01 00:00:00",
                "flwEndTime": "2024-01-31 23:59:59",
                "openTime": "2024-02-01 10:00:00",
                "goodslist": [
                    {
                        "title": "奖品名称",
                        "imgurl": "奖品图片",
                        "stock": 10,
                        "price": 99.00,
                        "scMoney": 50.00
                    }
                ]
            }
        ],
        "lastPage": 10,
        "total": 100
    }
}

8.2 获取福利屋详情

POST /fuliwu_detail

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/fuliwu_detail

请求头:

Authorization: Bearer {token}

请求参数:

{
    "goodsId": 1001
}

参数说明:

参数	类型	必填	说明
goodsId	int	是	商品ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "goods": {
            "id": 1001,
            "title": "福利屋活动",
            "imgurl": "商品图片",
            "imgurlDetail": "详情图片",
            "price": 0.00,
            "type": 15,
            "newIs": 0,
            "quanjuXiangou": 0,
            "choujiangXianzhi": 0,
            "goodsDescribe": "活动描述",
            "isOpen": 0,
            "unlockAmount": 100.00,
            "sort": 0,
            "flwStartTime": "2024-01-01 00:00",
            "flwEndTime": "2024-01-31 23:59",
            "openTime": "2024-02-01 10:00"
        },
        "goodslist": [
            {
                "id": 2001,
                "title": "奖品名称",
                "imgurl": "奖品图片",
                "imgurlDetail": "奖品详情图",
                "stock": 10,
                "price": 99.00,
                "scMoney": 50.00,
                "shangId": 1,
                "surplusStock": 5,
                "sort": 0,
                "shangTitle": "特等奖",
                "shangColor": "#FF0000"
            }
        ],
        "joinCount": 100,
        "currentTime": "2024-01-15 10:30:00",
        "userCount": 5,
        "userConsumption": {
            "totalAmount": 500.00,
            "orderCount": 10
        },
        "status": "ongoing",
        "statusText": "进行中"
    }
}

状态说明:

status	statusText	说明
waiting	即将开始	当前时间 < 开始时间
ongoing	进行中	开始时间 <= 当前时间 < 结束时间
ended	已结束，等待开奖	结束时间 <= 当前时间 < 开奖时间
to_open	待开奖	当前时间 >= 开奖时间且未开奖
opened	已开奖	当前时间 >= 开奖时间且已开奖

8.3 获取福利屋参与者

POST /fuliwu_participants

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/fuliwu_participants

请求头:

Authorization: Bearer {token}

请求参数:

{
    "goodsId": 1001,
    "page": 1,
    "limit": 15
}

参数说明:

参数	类型	必填	说明
goodsId	int	是	商品ID
page	int	否	页码，默认1
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "nickname": "用户昵称",
            "avatar": "头像URL",
            "createTime": "2024-01-15 10:30"
        }
    ]
}

8.4 获取福利屋开奖记录

POST /fuliwu_records

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/fuliwu_records

请求头:

Authorization: Bearer {token}

请求参数:

{
    "goodsId": 1001,
    "page": 1,
    "limit": 15
}

参数说明:

参数	类型	必填	说明
goodsId	int	是	商品ID
page	int	否	页码，默认1
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "nickname": "用户昵称",
            "avatar": "头像URL",
            "goodslistTitle": "奖品名称",
            "shangId": 1,
            "createTime": "2024-01-15 10:30"
        }
    ]
}

8.5 获取用户福利屋参与记录

GET /fuliwu_user_records

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: GET /api/fuliwu_user_records

请求头:

Authorization: Bearer {token}

请求参数:

参数	类型	必填	说明
page	int	否	页码，默认1
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "goodsId": 1001,
            "goodsTitle": "福利屋活动",
            "goodslistTitle": "奖品名称",
            "shangId": 1,
            "createTime": "2024-01-15 10:30"
        }
    ]
}

8.6 获取用户福利屋中奖记录

GET /fuliwu_user_winning_records

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: GET /api/fuliwu_user_winning_records

请求头:

Authorization: Bearer {token}

请求参数:

参数	类型	必填	说明
page	int	否	页码，默认1
limit	int	否	每页数量，默认15

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "goodsId": 1001,
            "goodsTitle": "福利屋活动",
            "goodslistTitle": "奖品名称",
            "shangId": 1,
            "createTime": "2024-02-01 10:00"
        }
    ]
}

8.7 获取任务列表

POST /task_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/task_list

请求头:

Authorization: Bearer {token}

请求参数:

{
    "type": 1
}

参数说明:

参数	类型	必填	说明
type	int	否	任务类型：1-每日任务，2-每周任务，默认1

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "taskList": [
            {
                "id": 1,
                "type": 1,
                "cate": 1,
                "title": "邀请1位好友注册",
                "number": 1,
                "zNumber": 10,
                "isComplete": 0,
                "percentage": 0,
                "ywcCount": 0
            },
            {
                "id": 2,
                "type": 1,
                "cate": 2,
                "title": "完成1次抽赏",
                "number": 1,
                "zNumber": 5,
                "isComplete": 1,
                "percentage": 100,
                "ywcCount": 1
            }
        ]
    }
}

字段说明:

字段	说明
id	任务ID
type	任务类型：1-每日，2-每周
cate	任务分类：1-邀请，2-抽赏
title	任务标题
number	目标完成数量
zNumber	奖励欧气值
isComplete	完成状态：0-未完成，1-已完成，2-已领取
percentage	完成百分比(0-100)
ywcCount	已完成次数

8.8 领取任务奖励

POST /ling_task

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/ling_task

请求头:

Authorization: Bearer {token}

请求参数:

{
    "taskListId": 1001
}

参数说明:

参数	类型	必填	说明
taskListId	int	是	任务ID

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "reward": 10,
        "currentOuQi": 150
    }
}

字段说明:

字段	说明
reward	本次获得的欧气值奖励
currentOuQi	当前欧气值总数

错误说明:

任务不存在：返回 "任务不存在"
任务未完成：返回 "任务未完成"
已领取过：返回 "你已经领取过了"

9. 系统配置接口

9.1 获取全局配置

GET /config

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "good_type": [
            {
                "value": 1,
                "name": "一番赏",
                "is_show": 1,
                "pay_wechat": 1,
                "pay_balance": 1
            }
        ],
        "app_setting": {
            "app_name": "友达赏",
            "balance_name": "钻石",
            "currency1_name": "UU币",
            "currency2_name": "哈尼券",
            "applet_version": "v1.0.3"
        }
    }
}

9.2 获取轮播图

GET /getAdvert

请求参数:

参数	类型	必填	说明
type_id	int	否	类型：1-首页轮播，2-抽卡机轮播

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": [
        {
            "id": 1,
            "imgurl": "轮播图URL",
            "url": "跳转链接",
            "ttype": 2,
            "goods_id": 1001
        }
    ]
}

9.3 获取单页内容

GET /getDanye

请求参数:

参数	类型	必填	说明
type	int	是	页面类型：1-服务协议，2-隐私政策，3-公告

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "title": "用户协议",
        "content": "协议内容..."
    }
}

9.4 获取优惠券中心

POST /coupon

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "status": 1,
        "goods": {
            "list": [
                {
                    "id": 60001,
                    "title": "新人券",
                    "price": "5.00"
                }
            ]
        }
    }
}

9.5 领取优惠券

POST /receive

请求参数:

{
    "coupon_id": "60001,60002"
}

9.6 添加收藏

POST /addCollect

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/addCollect

请求参数:

{
    "goods_id": 1001,
    "goods_num": 0
}

参数说明:

参数	类型	必填	说明
goods_id	int	是	商品ID
goods_num	int	否	箱号，默认0

响应示例:

{
    "status": 1,
    "msg": "操作成功"
}

9.7 收藏列表

POST /listCollect

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/listCollect

请求参数:

{
    "type": 0,
    "page": 1,
    "page_size": 100
}

参数说明:

参数	类型	必填	说明
type	int	否	商品类型，0=全部
page	int	否	页码，默认1
page_size	int	否	每页数量，默认100

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "data": [
            {
                "id": 1,
                "goods_id": 1001,
                "type": 1,
                "num": 0,
                "goods_title": "商品标题",
                "goods_price": "99.00",
                "imgurl": "图片URL",
                "stock": 100,
                "surplus_stock": 50
            }
        ],
        "last_page": 1
    }
}

9.8 删除收藏

POST /delCollect

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/delCollect

请求参数:

{
    "id": 1
}

参数说明:

参数	类型	必填	说明
id	int	是	收藏记录ID

响应示例:

{
    "status": 1,
    "msg": "删除成功"
}

10. 其他功能接口

10.1 获取排行榜

GET /getRankList

请求参数:

参数	类型	必填	说明
type	string	是	排行榜类型：invite-邀请榜，consume-消费榜

10.1.1 获取周榜

GET /rank_week

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: GET /api/rank_week

请求头:

Authorization: Bearer {token}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "date": "01月01日-01月07日",
        "end_date": 1704643199,
        "my_rank": {
            "my_rank": 5,
            "my_prize_title": "限定手办",
            "my_prize_imgurl": "奖品图片URL",
            "my_order_total": 1500.00,
            "my_nickname": "用户昵称",
            "my_headimg": "头像URL"
        },
        "data": [
            {
                "rank": 1,
                "user_id": 1001,
                "nickname": "用户昵称",
                "headimg": "头像URL",
                "order_total": 5000.00,
                "prize_title": "特等奖",
                "prize_imgurl": "奖品图片URL"
            }
        ]
    }
}

字段说明:

字段	说明
date	周榜日期范围
end_date	周榜结束时间戳
my_rank	当前用户排名信息（未上榜时为"暂未上榜"）
my_prize_title	当前用户对应奖品标题（未上榜时为0）
my_prize_imgurl	当前用户对应奖品图片（未上榜时为0）
my_order_total	当前用户本周消费金额
data	排行榜前30名列表

10.1.2 获取月榜

GET /rank_month

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: GET /api/rank_month

请求头:

Authorization: Bearer {token}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "date": "01月01日-01月31日",
        "end_date": 1706716799,
        "my_rank": {
            "my_rank": "暂未上榜",
            "my_prize_title": 0,
            "my_prize_imgurl": 0,
            "my_order_total": 500.00,
            "my_nickname": "用户昵称",
            "my_headimg": "头像URL"
        },
        "data": [
            {
                "rank": 1,
                "user_id": 1001,
                "nickname": "用户昵称",
                "headimg": "头像URL",
                "order_total": 15000.00,
                "prize_title": "月度特等奖",
                "prize_imgurl": "奖品图片URL"
            }
        ]
    }
}

字段说明:

字段	说明
date	月榜日期范围
end_date	月榜结束时间戳
my_rank	当前用户排名信息（未上榜时为"暂未上榜"）
my_prize_title	当前用户对应奖品标题（未上榜时为0）
my_prize_imgurl	当前用户对应奖品图片（未上榜时为0）
my_order_total	当前用户本月消费金额
data	排行榜前30名列表

10.2 获取邀请信息

POST /invitation

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/invitation

请求头:

Authorization: Bearer {token}

请求参数:

{
    "page": 1
}

参数说明:

参数	类型	必填	说明
page	int	否	页码，默认1

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "share_title": "分享标题",
        "share_image": "",
        "count": 10,
        "money": 150.00,
        "data": [
            {
                "id": 1002,
                "nickname": "被邀请用户",
                "headimg": "头像URL",
                "pid": 1001,
                "addtime": "2024-01-01 10:30:00",
                "commission_money": 15.00
            }
        ],
        "last_page": 1
    }
}

字段说明:

字段	说明
share_title	分享标题
share_image	分享图片URL
count	总邀请人数
money	总奖励金额
data	邀请记录列表
last_page	最后一页页码

10.3 绑定邀请码

POST /bind_invite_code

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/bind_invite_code

请求头:

Authorization: Bearer {token}

请求参数:

{
    "invite_code": "ABC123"
}

参数说明:

参数	类型	必填	说明
invite_code	string	是	邀请码（邀请人的UID）

响应示例:

{
    "status": 1,
    "msg": "绑定成功"
}

错误说明:

用户不存在：返回 "用户不存在"
已绑定过：返回 "您已绑定过邀请码"
超过24小时：返回 "新用户注册24小时内才可以绑定邀请码"
绑定自己：返回 "不能绑定自己"
邀请码不存在：返回 "邀请码不存在"

10.4 获取VIP列表

POST /vip_list

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/vip_list

请求头:

Authorization: Bearer {token}

响应示例:

{
    "status": 1,
    "msg": "success",
    "data": {
        "userinfo": {
            "nickname": "用户昵称",
            "headimg": "头像URL",
            "vip": 2,
            "upgrade_money": "500.00",
            "last_vip": 3,
            "jin_du": 60.5,
            "notice": "VIP2会员"
        },
        "data": [
            {
                "id": 1,
                "level": 1,
                "title": "VIP1",
                "imgurl": "",
                "condition": 100,
                "discount": 0,
                "notice": "VIP1会员"
            },
            {
                "id": 2,
                "level": 2,
                "title": "VIP2",
                "imgurl": "",
                "condition": 500,
                "discount": 0,
                "notice": "VIP2会员"
            }
        ]
    }
}

10.5 使用兑换码

POST /used

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/used

请求头:

Authorization: Bearer {token}

请求参数:

{
    "code": "EXCHANGE123"
}

参数说明:

参数	类型	必填	说明
code	string	是	兑换码

响应示例:

{
    "status": 1,
    "msg": "兑换成功，获得100吧唧币",
    "data": {
        "success": true,
        "message": "兑换成功，获得100吧唧币",
        "rewardType": "integral",
        "rewardAmount": 100.00
    }
}

字段说明:

字段	说明
success	是否成功
message	提示消息
rewardType	奖励类型：money=余额, integral=吧唧币, score=积分
rewardAmount	奖励数量

错误说明:

兑换码无效：返回 "兑换码无效"
兑换码已被使用：返回 "兑换码已被使用"
兑换码已过期：返回 "兑换码已过期"

11. 错误码说明

错误码	说明
1	请求成功
0	请求失败
-1	用户未登录
-9	需要绑定手机号
2222	特殊状态（如已领取、已完成等）

12. UniApp小程序接口调用示例

12.1 请求封装使用

// 在小程序页面中调用API
export default {
    methods: {
        // 获取商品列表
        async getGoodsList() {
            try {
                const res = await this.$request.post('goods', {
                    page: 1,
                    type: 0
                });
                
                if (res.status === 1) {
                    this.goodsList = res.data.data;
                } else {
                    this.$c.toast(res.msg);
                }
            } catch (error) {
                console.error('获取商品列表失败:', error);
            }
        },
        
        // 创建订单并支付
        async createOrder() {
            const res = await this.req({
                url: 'orderbuy',
                data: {
                    goods_id: this.goodsId,
                    num: 0,
                    prize_num: 1,
                    use_money_is: 2,
                    use_integral_is: 2
                }
            });
            
            if (res.status === 1 && res.data.status === 1) {
                // 调起微信支付
                const payResult = await this.$platform.pay({
                    data: res.data.res
                }, this);
                
                if (payResult === 'success') {
                    // 支付成功，获取抽奖结果
                    this.getPrizeResult(res.data.order_num);
                }
            }
        },
        
        // 获取抽奖结果
        async getPrizeResult(orderNum) {
            const res = await this.$request.post('prizeorderlog', {
                order_num: orderNum
            });
            
            if (res.status === 1) {
                // 显示中奖结果
                this.showPrizeResult(res.data);
            }
        }
    }
}

12.2 配置管理使用

// 获取全局配置
const appName = this.$config.getAppSetting('app_name');
const balanceName = this.$config.getAppSetting('balance_name');

// 获取商品类型配置
const goodTypes = this.$config.getGoodType();

// 检查支付方式
const goodTypeConfig = this.$config.getGoodTypeFind(1); // 一番赏
if (goodTypeConfig.pay_wechat === 1) {
    // 支持微信支付
}

12.3 路由跳转使用

// 跳转到商品详情页
this.$c.to({
    url: '/pages/shouye/detail',
    query: {
        goods_id: 1001,
        num: 0
    }
});

// 跳转到用户中心
this.$customRouter.navigateTo('/pages/user/index');

12.4 平台适配使用

// 调起支付（自动适配不同平台）
const payResult = await this.$platform.pay({
    data: payParams
}, this);

// 平台特定功能
if (this.$platform.code === 'mp-weixin') {
    // 微信小程序特有功能
    wx.requestPayment(payParams);
}

这份更新后的API文档基于小程序中实际使用的接口，包含了完整的请求参数、响应格式和使用示例，更贴近实际开发需求。

13. 支付回调接口

13.1 微信支付回调

POST /api/notify/order_notify

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/notify/order_notify

说明: 此接口由微信支付服务器调用，用于通知支付结果。不需要前端调用。

请求格式: XML

请求示例:

<xml>
    <return_code><![CDATA[SUCCESS]]></return_code>
    <return_msg><![CDATA[OK]]></return_msg>
    <appid><![CDATA[wx1234567890]]></appid>
    <mch_id><![CDATA[1234567890]]></mch_id>
    <nonce_str><![CDATA[abc123]]></nonce_str>
    <sign><![CDATA[SIGN_STRING]]></sign>
    <result_code><![CDATA[SUCCESS]]></result_code>
    <openid><![CDATA[user_openid]]></openid>
    <trade_type><![CDATA[JSAPI]]></trade_type>
    <total_fee>100</total_fee>
    <out_trade_no><![CDATA[ORDER_NO]]></out_trade_no>
    <attach><![CDATA[order_yfs]]></attach>
    <time_end><![CDATA[20240101120000]]></time_end>
</xml>

attach参数说明:

attach值	订单类型	说明
user_recharge	余额充值	用户充值订单
order_yfs	一番赏订单	一番赏抽奖订单
order_lts	擂台赏订单	擂台赏抽奖订单
order_zzs	转转赏订单	转转赏抽奖订单
order_flw	福利屋订单	福利屋抽奖订单
order_scs	商城赏订单	商城赏抽奖订单
order_wxs	无限赏订单	无限赏抽奖订单
order_fbs	翻倍赏订单	翻倍赏抽奖订单
order_ckj	抽卡机订单	抽卡机抽奖订单
order_list_send	发货运费	背包发货运费订单

响应格式: XML

响应示例:

<xml>
    <return_code><![CDATA[SUCCESS]]></return_code>
    <return_msg><![CDATA[OK]]></return_msg>
</xml>

处理流程:

验证签名确保数据安全
检查订单是否已处理（幂等性）
根据attach类型路由到对应处理方法
更新订单状态、扣减用户资产
触发抽奖逻辑（如适用）
返回XML响应给微信

13.2 微信支付统一下单

POST /api/pay

迁移状态: ✅ 已迁移到 .NET 8 新接口地址: POST /api/pay

说明: 创建微信支付订单，返回支付参数供前端调起微信支付。

请求头:

Authorization: Bearer {token}

请求参数:

{
    "order_no": "YFS_20240101120000_1001",
    "amount": 9.90,
    "body": "一番赏抽奖",
    "attach": "order_yfs",
    "open_id": ""
}

参数说明:

参数	类型	必填	说明
order_no	string	是	订单号
amount	decimal	是	支付金额（单位：元）
body	string	否	商品描述，默认"商品购买"
attach	string	是	订单类型（见attach参数说明）
open_id	string	否	用户OpenId，不传则从用户信息获取

响应示例（成功）:

{
    "status": 1,
    "msg": "success",
    "data": {
        "appId": "wx1234567890",
        "timeStamp": "1640995200",
        "nonceStr": "abc123def456",
        "package": "prepay_id=wx123456789",
        "signType": "MD5",
        "paySign": "SIGN_STRING",
        "is_weixin": 1
    }
}

响应示例（失败）:

{
    "status": 0,
    "msg": "订单号不能为空",
    "data": null
}

前端调起支付示例:

// 获取支付参数
const payResult = await request({
    url: '/api/pay',
    method: 'POST',
    data: {
        order_no: orderNo,
        amount: totalPrice,
        body: '一番赏抽奖',
        attach: 'order_yfs'
    }
});

if (payResult.status === 1 && payResult.data) {
    // 调起微信支付
    wx.requestPayment({
        timeStamp: payResult.data.timeStamp,
        nonceStr: payResult.data.nonceStr,
        package: payResult.data.package,
        signType: payResult.data.signType,
        paySign: payResult.data.paySign,
        success: function(res) {
            // 支付成功
        },
        fail: function(res) {
            // 支付失败
        }
    });
}

59 KiB Raw Blame History Unescape Escape

抽奖盲盒系统API接口文档

1. 接口概览

基础信息

通用响应格式

状态码说明

请求签名机制

2. 用户认证接口

2.1 发送短信验证码

2.2 手机号登录

2.3 微信授权登录

2.4 获取用户信息

2.5 更新用户信息

2.6 注销账号

2.6 微信授权绑定手机号

2.7 验证码绑定手机号

2.8 记录用户登录

3. 商品相关接口

3.1 获取首页商品列表

3.2 获取商品详情（一番赏）

3.3 获取商品子奖品

3.4 获取商品扩展配置

3.5 获取箱号列表

3.6 获取箱号详情

3.7 获取无限赏商品详情

3.4 获取商品奖品数量统计

3.5 获取商品奖品内容

3.6 获取预售日历

4. 订单相关接口

4.1 计算订单金额（一番赏）

4.2 创建订单并支付（一番赏）

4.3 无限赏订单金额计算

4.4 无限赏创建订单

4.5 商城订单金额计算

4.6 获取订单列表

4.7 获取订单详情

5. 抽奖相关接口

5.1 获取抽奖结果（一番赏）

5.2 获取无限赏抽奖结果

5.3 获取中奖记录

5.4 获取无限赏中奖记录

5.5 获取用户抽奖记录（盒子抽奖记录）

5.6 使用道具卡抽奖

6. 盒柜（仓库）相关接口

6.1 获取仓库首页

6.2 回收奖品

6.3 发货奖品

6.4 确认发货

6.5 获取发货记录

6.6 获取发货记录详情

6.7 获取回收记录

6.8 获取物流信息

7. 财务相关接口

7.1 获取资金明细

7.2 获取吧唧币明细

7.3 获取积分明细

7.4 获取支付明细

7.4 获取优惠券列表

7.4.1 获取优惠券详情

7.5 领取优惠券

7.6 分享优惠券

7.7 合成优惠券

7.8 计算优惠券合成

8. 福利相关接口

8.1 获取福利屋列表

8.2 获取福利屋详情

8.3 获取福利屋参与者

8.4 获取福利屋开奖记录

8.5 获取用户福利屋参与记录

8.6 获取用户福利屋中奖记录

8.7 获取任务列表

8.8 领取任务奖励

9. 系统配置接口

9.1 获取全局配置

9.2 获取轮播图

9.3 获取单页内容

9.4 获取优惠券中心

9.5 领取优惠券

9.6 添加收藏

9.7 收藏列表

59 KiB

Raw Blame History