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 | 
