Skip to content

一物一码 模块

MODULE_NAMEMODULE_DESC入参返参路径
ywym_user抽奖用户信息YwymUserParamsYwymUserRespywym/index/user
ywym_win_lists抽奖记录列表YwymWinListsParamsYwymWinListsRespywym/index/winlists
ywym_rand抽奖YwymRandParamsYwymRandRespywym/index/rand
ywym_info奖品信息YwymInfoParamsYwymInfoRespywym/index/info
ywym_send_add发送地址YwymSendAddParamsYwymSendAddRespywym/index/sendaddress
bind_phone绑定手机号BindPhoneParamsBindPhoneRespuser/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用户 IDnumber
└─ app_id应用 IDnumber
└─ user_id用户 IDnumber
└─ uname用户名string
└─ name姓名string
└─ channel渠道number
└─ id_card身份证号码string
└─ phone手机号码string
└─ longitude经度string
└─ latitude纬度string
└─ province省份string
└─ province_id省份 IDnumber
└─ city城市string
└─ city_id城市 IDnumber
└─ address地址string
└─ geo_province地理位置省份string
└─ geo_province_id地理位置省份 IDnumber
└─ geo_city地理位置城市string
└─ geo_city_id地理位置城市 IDnumber
└─ geo_district地理位置区县string
└─ plant_id植物 IDnumber
└─ plant_name植物名称string
└─ plant_code植物编码string
└─ plant_flavor植物风味string
└─ ipIP 地址string
└─ ip_register注册 IP 地址string
└─ check_count检查次数number
└─ scan_count扫描次数number
└─ operator_id操作员 IDnumber
└─ created_at创建时间string
└─ updated_at更新时间string
└─ state状态number
└─ csec_level安全等级number
└─ nickname昵称string
└─ headimgurl头像 URLstring
redbag红包信息对象object
└─ open是否开启红包number
└─ user用户相关红包信息object
└─── id用户 IDnumber
└─── app_id应用 IDnumber
└─── user_id用户 IDnumber
└─── no_use未使用金额string
└─── has_use已使用金额string
└─── redbag红包金额string
└─── day_extract当天提取金额string
└─── sidSIDstring
└─── realip真实 IP 地址string
└─── operator_id操作员 IDnumber
└─── 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
pagestring页数
limitstring条数

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抽奖记录 IDnumber
prize_id奖品 IDnumber
item_amounts奖品数量string
skip_url跳转链接string
lottery_id抽奖 IDnumber
created_at创建时间string
lottery_date抽奖日期string
user_id用户 IDnumber
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
qrcodestring抽奖码

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抽奖记录 IDnumber
prize_id奖品 IDnumber
item_amounts奖品数量string
skip_url跳转链接string
lottery_id抽奖 IDnumber
created_at创建时间string
lottery_date抽奖日期string
user_id用户 IDnumber
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抽奖记录 IDnumber
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
namestring收件人
phonestring手机号
provincestring
citystring
areastring
addressstring详细地址

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手机号
smscodestring验证码

BindPhoneResp 参数

ts
interface BIND_PHONE_RESP {
  phone: string; // 手机号
}
参数名参数描述类型
phone手机号string