Appearance
一物一码 模块
| MODULE_NAME | MODULE_DESC | 入参 | 返参 | 路径 |
|---|---|---|---|---|
| ywym_user | 抽奖用户信息 | YwymUserParams | YwymUserResp | ywym/index/user |
| ywym_win_lists | 抽奖记录列表 | YwymWinListsParams | YwymWinListsResp | ywym/index/winlists |
| ywym_rand | 抽奖 | YwymRandParams | YwymRandResp | ywym/index/rand |
| ywym_info | 奖品信息 | YwymInfoParams | YwymInfoResp | ywym/index/info |
| ywym_send_add | 发送地址 | YwymSendAddParams | YwymSendAddResp | ywym/index/sendaddress |
| bind_phone | 绑定手机号 | BindPhoneParams | BindPhoneResp | user/index/bindphone |
抽奖用户信息
YwymUserParams 参数
ts
interface YWYM_USER_PARAMS {
act_id: string; // 抽奖活动code
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| act_id: | string | 抽奖活动 code | 是 |
YwymUserResp 参数
ts
interface YWYM_USER_RESP {
user: {
id: number; // 用户ID
app_id: number; // 应用ID
user_id: number; // 用户ID
uname: string; // 用户名
name: string; // 姓名
channel: number; // 渠道
id_card: string; // 身份证号码
phone: string; // 手机号码
longitude: string; // 经度
latitude: string; // 纬度
province: string; // 省份
province_id: number; // 省份ID
city: string; // 城市
city_id: number; // 城市ID
address: string; // 地址
geo_province: string; // 地理位置省份
geo_province_id: number; // 地理位置省份ID
geo_city: string; // 地理位置城市
geo_city_id: number; // 地理位置城市ID
geo_district: string; // 地理位置区县
plant_id: number; // 植物ID
plant_name: string; // 植物名称
plant_code: string; // 植物编码
plant_flavor: string; // 植物风味
ip: string; // IP地址
ip_register: string; // 注册IP地址
check_count: number; // 检查次数
scan_count: number; // 扫描次数
operator_id: number; // 操作员ID
created_at: string; // 创建时间
updated_at: string; // 更新时间
state: number; // 状态
csec_level: number; // 安全等级
nickname: string; // 昵称
headimgurl: string; // 头像URL
};
redbag: {
open: number; // 是否开启红包
user: {
id: number; // 用户ID
app_id: number; // 应用ID
user_id: number; // 用户ID
no_use: string; // 未使用金额
has_use: string; // 已使用金额
redbag: string; // 红包金额
day_extract: string; // 当天提取金额
sid: string; // SID
realip: string; // 真实IP地址
operator_id: number; // 操作员ID
created_at: string; // 创建时间
updated_at: string; // 更新时间
};
};
is_wechat: number; // 是否为微信用户
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| is_wechat | 是否为微信用户(0 否 1 是) | number |
| user | 用户信息对象 | object |
| └─ id | 用户 ID | number |
| └─ app_id | 应用 ID | number |
| └─ user_id | 用户 ID | number |
| └─ uname | 用户名 | string |
| └─ name | 姓名 | string |
| └─ channel | 渠道 | number |
| └─ id_card | 身份证号码 | string |
| └─ phone | 手机号码 | string |
| └─ longitude | 经度 | string |
| └─ latitude | 纬度 | string |
| └─ province | 省份 | string |
| └─ province_id | 省份 ID | number |
| └─ city | 城市 | string |
| └─ city_id | 城市 ID | number |
| └─ address | 地址 | string |
| └─ geo_province | 地理位置省份 | string |
| └─ geo_province_id | 地理位置省份 ID | number |
| └─ geo_city | 地理位置城市 | string |
| └─ geo_city_id | 地理位置城市 ID | number |
| └─ geo_district | 地理位置区县 | string |
| └─ plant_id | 植物 ID | number |
| └─ plant_name | 植物名称 | string |
| └─ plant_code | 植物编码 | string |
| └─ plant_flavor | 植物风味 | string |
| └─ ip | IP 地址 | string |
| └─ ip_register | 注册 IP 地址 | string |
| └─ check_count | 检查次数 | number |
| └─ scan_count | 扫描次数 | number |
| └─ operator_id | 操作员 ID | number |
| └─ created_at | 创建时间 | string |
| └─ updated_at | 更新时间 | string |
| └─ state | 状态 | number |
| └─ csec_level | 安全等级 | number |
| └─ nickname | 昵称 | string |
| └─ headimgurl | 头像 URL | string |
| redbag | 红包信息对象 | object |
| └─ open | 是否开启红包 | number |
| └─ user | 用户相关红包信息 | object |
| └─── id | 用户 ID | number |
| └─── app_id | 应用 ID | number |
| └─── user_id | 用户 ID | number |
| └─── no_use | 未使用金额 | string |
| └─── has_use | 已使用金额 | string |
| └─── redbag | 红包金额 | string |
| └─── day_extract | 当天提取金额 | string |
| └─── sid | SID | string |
| └─── realip | 真实 IP 地址 | string |
| └─── operator_id | 操作员 ID | number |
| └─── created_at | 创建时间 | string |
| └─── updated_at | 更新时间 | string |
抽奖记录列表
YwymWinListsParams 参数
ts
interface YWYM_WIN_LISTS_PARAMS {
act_id: string; // 抽奖活动code
page: string; // 页数
limit: string; // 条数
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| act_id: | string | 抽奖活动 code | 是 |
| page | string | 页数 | 是 |
| limit | string | 条数 | 是 |
YwymWinListsResp 参数
ts
interface YWYM_WIN_LISTS_RESP {
id: number; // 抽奖记录ID
prize_id: number; // 奖品ID
item_amounts: string; // 奖品数量
skip_url: string; // 跳转链接
lottery_id: number; // 抽奖ID
created_at: string; // 创建时间
lottery_date: string; // 抽奖日期
user_id: number; // 用户ID
uname: string; // 用户名
phone: string; // 手机号码
address: string; // 地址
lottery_name: string; // 抽奖名称
prize_name: string; // 奖品名称
prize_img_title: string; // 奖品图片标题
prize_img: string; // 奖品图片
item_type: number; // 获奖等级
win_type: number; // 奖品类型
win_button_img: string; // 奖品按钮图片
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| id | 抽奖记录 ID | number |
| prize_id | 奖品 ID | number |
| item_amounts | 奖品数量 | string |
| skip_url | 跳转链接 | string |
| lottery_id | 抽奖 ID | number |
| created_at | 创建时间 | string |
| lottery_date | 抽奖日期 | string |
| user_id | 用户 ID | number |
| uname | 用户名 | string |
| phone | 手机号码 | string |
| address | 地址 | string |
| lottery_name | 抽奖名称 | string |
| prize_name | 奖品名称 | string |
| prize_img_title | 奖品图片标题 | string |
| prize_img | 奖品图片 | string |
| item_type | 获奖等级 | number |
| win_type | 奖品类型 | number |
| win_button_img | 奖品按钮图片 | string |
抽奖
YwymRandParams 参数
ts
interface YWYM_RAND_PARAMS {
act_id: string; // 抽奖活动code
qrcode: string; // 抽奖码
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| act_id: | string | 抽奖活动 code | 是 |
| qrcode | string | 抽奖码 | 是 |
YwymRandResp 参数
ts
interface YWYM_RAND_RESP {
// is_auth: boolean; // 是否授权
// prize: array; // 奖品列表
// log_id: number; // 抽奖记录ID
// is_wechat: number; // 是否微信端
id: number; // 抽奖记录ID
prize_id: number; // 奖品ID
item_amounts: string; // 奖品数量
skip_url: string; // 跳转链接
lottery_id: number; // 抽奖ID
created_at: string; // 创建时间
lottery_date: string; // 抽奖日期
user_id: number; // 用户ID
uname: string; // 用户名
phone: string; // 手机号码
address: string; // 地址
lottery_name: string; // 抽奖名称
prize_name: string; // 奖品名称
prize_img_title: string; // 奖品图片标题
prize_img: string; // 奖品图片
item_type: number; // 获奖等级
win_type: number; // 奖品类型
win_button_img: string; // 奖品按钮图片
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| id | 抽奖记录 ID | number |
| prize_id | 奖品 ID | number |
| item_amounts | 奖品数量 | string |
| skip_url | 跳转链接 | string |
| lottery_id | 抽奖 ID | number |
| created_at | 创建时间 | string |
| lottery_date | 抽奖日期 | string |
| user_id | 用户 ID | number |
| uname | 用户名 | string |
| phone | 手机号码 | string |
| address | 地址 | string |
| lottery_name | 抽奖名称 | string |
| prize_name | 奖品名称 | string |
| prize_img_title | 奖品图片标题 | string |
| prize_img | 奖品图片 | string |
| item_type | 获奖等级 | number |
| win_type | 奖品类型 | number |
| win_button_img | 奖品按钮图片 | string |
奖品信息
YwymInfoParams 参数
ts
interface YWYM_INFO_PARAMS {
act_id: string; // 抽奖活动code
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| act_id: | string | 抽奖活动 code | 是 |
YwymInfoResp 参数
ts
interface YWYM_INFO_RESP {
id: number; // 抽奖记录ID
prize_name: string; // 奖品名称
prize_img_title: string; // 奖品图片标题
prize_img: string; // 奖品图片
prize_desc: string; // 奖品描述
item_type: number; // 获奖等级
express_desc: string; // 兑奖说明文字
win_button_img: string; // 奖品按钮图片
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| id | 抽奖记录 ID | number |
| prize_name | 奖品名称 | string |
| prize_img_title | 奖品图片标题 | string |
| prize_img | 奖品图片 | string |
| prize_desc | 奖品描述 | string |
| item_type | 获奖等级 | number |
| express_desc | 兑奖说明文字 | string |
| win_button_img | 奖品按钮图片 | string |
发送地址
YwymSendAddParams 参数
ts
interface YWYM_INFO_PARAMS {
log_id: string; // 记录ID
name: string; // 收件人
phone: string; // 手机号
province: string; // 省
city: string; // 市
area: string; // 区
address: string; // 详细地址
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| log_id: | string | 记录 ID | 是 |
| name | string | 收件人 | 是 |
| phone | string | 手机号 | 是 |
| province | string | 省 | 是 |
| city | string | 市 | 是 |
| area | string | 区 | 是 |
| address | string | 详细地址 | 是 |
YwymSendAddResp 参数
ts
interface YWYM_INFO_RESP {
data: string; // 提示语
is_wechat: number; // 是否微信端
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| data | 提示语 | string |
| is_wechat | 是否微信端 | number |
绑定手机号
BindPhoneParams 参数
ts
interface BIND_PHONE_PARAMS {
phone: string; // 手机号
smscode: string; // 验证码
}| 参数名 | 类型 | 描述 | 必传 |
|---|---|---|---|
| phone: | string | 手机号 | 是 |
| smscode | string | 验证码 | 是 |
BindPhoneResp 参数
ts
interface BIND_PHONE_RESP {
phone: string; // 手机号
}| 参数名 | 参数描述 | 类型 |
|---|---|---|
| phone | 手机号 | string |
