互动-商品
互动-商品
关键方法
| 方法 | 方法描述 |
|---|---|
| GoodsServer | 商品推屏总服务 |
| GoodsServer.getGoodsList | 获取推屏商品列表 |
| GoodsServer.getGoodsInfo | 获取商品信息 |
| GoodsServer.getGoodsOrderSetting | 获取活动下商品订单提交信息设置项 |
| GoodsServer.createOrder | 创建订单 |
| GoodsServer.payOrder | 支付订单，只支持平台支付商品， 根据订单信息唤起微信或支付宝进行支付 |
| GoodsServer.getGoodsOrderInfo | 获取订单信息 |
关键事件
| 方法 | 方法描述 |
|---|---|
| MessageServer.EVENT_PUSH_GOODS_CARD | 商品推屏消息 |
| MessageServer.EVENT_GOOD_UPDATE_INFO | 商品信息修改消息 |
消息回调
商品推屏服务
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| webinarInfo | 是 | 活动信息 | |
| context | 是 | 上下文 | |
| goodsMessageCallBack | 否 | 消息回调 GoodsMessageCallBack |
获取推送的推屏商品列表
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| success | GoodsInfoData |
接口返回值
信息字段说明
| 字段名称 | 说明 |
|---|---|
| GoodsInfoData | 信息字段说明 |
| total | 商品总数 |
| List#GoodsInfo | 商品列表 |
| 字段名称 | 说明 |
|---|---|
| goods_id | 商品ID |
| name | 商品名称 |
| description | 商品描述 |
| price | 两位有效数字的浮点数 |
| discount_price | 优惠后价格 |
| buy_type | 购买类型;1.平台购买 2.外链购买 3.自定义购买 |
| third_goods_id | 三方商品ID 用于打通客户商品体系 |
| url | 商品链接 |
| shop_show | 显示店铺 |
| shop_url | 店铺链接 |
| cover_img | 封面图片地址 |
| cover_img_scale_type | ImageView.ScaleType 封面图片填充模式 图片填充模式：ImageView.ScaleType |
| images | 图片集合 GoodsInfoData#ImageInfo |
| tao_password | 淘口令 |
| scheme_template | 自定义购买链接 |
| qr_code_url | 二维码链接 |
| status | 上架状态;(0.下架 1.上架 2.推送上架) |
| push_status | 推送状态;(0.未推送 1. 推送中 2.已推送) |
| order_num | 排序 |
| webinar_goods_id | 活动下商品ID 暂时只有发起端使用 |
| cdn_url | 商品列表cdn地址用于加速使用 |
| action | 1 添加商品信息 2 修改商品信息 3 删除商品 4列表商品变更 |
| del_goods_ids | List#String 消息中删除的商品id列表 |
获取商品信息
| 字段名称 | 说明 | |
|---|---|---|
| goods_id | 是 | 商品id |
| success | 是 | GoodsInfoData.GoodsInfo |
接口返回值
信息字段说明
获取活动下商品订单提交信息设置项
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| success | GoodsOrderSetting |
GoodsOrderSetting
| 字段名称 | 说明 |
|---|---|
| webinar_id | 活动ID |
| enable_username | 是否需要 填写用户名 |
| enable_phone | 是否需要填写手机号 |
| enable_remark | 是否需要填写备注 |
| enable_weixin | 是否支持微信支付 |
| enable_alipay | 是否支持支付宝支付 |
创建订单
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| goods_id | 是 | 商品ID | |
| quantity | 是 | 购买数量 | |
| pay_amount | 是 | 总金额 | |
| pay_channel | 是 | 支付渠道 微信 GoodsServer.PAY_TYPE_WEIXIN 支付宝 GoodsServer.PAY_TYPE_ALIPAY | |
| username | 否 | 姓名 用户姓名不能超过30个字符 | |
| phone | 否 | 手机号 手机号不能超过11个字符 并且必须是1开头数字 | |
| remark | 否 | 留言备注不能超过50个字符 | |
| channel_source | 否 | 下单渠道 默认main | |
| coupon_user_ids | 否 | 使用优惠券列表，优惠卷信息CouponInfoData 中的 coupon_user_id | |
| success | OrderInfoData |
OrderInfoData
| 字段名称 | 说明 |
|---|---|
| order_no | 订单号 |
| order_status | 订单状态 SUCCESS |
| order_url | 订单跳转url， 自定义购买时跳转scheme |
| trade_no | 交易流水号 |
| pay_time | 支付时间 |
| total_amount | 订单总金额 |
| pay_amount | 实付金额 |
| webinar_id | 活动ID |
| webinar_subject | 活动名称 |
| created_at | 下单时间 |
| username | 用户姓名 |
| phone | 用户手机号 |
| remark | 用户留言 |
| channel_source | 渠道来源 |
| pay_channel | 支付渠道 |
| service_code | 支付方式 |
| buy_type | 购买类型(1.平台购买 2.外链购买 3.自定义购买) |
| order_items |
支付订单
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| context | Context | ||
| orderInfo | 创建的订单信息 | ||
| callBack | 调用结果回调 |
获取订单信息
| 参数名称 | 是否必须 | 示例 | 备注 |
|---|---|---|---|
| order_no | 订单号 | ||
| success | OrderInfoData |
商品推屏消息
商品推屏消息回调
发送商品推屏卡片
/*
* 商品推屏消息 商品数据 msgInfo.goodsInfo
* push_status： 推送状态;(0.未推送 1. 推送中 2.已推送)
*/
ExamMessageCallBack.pushGoodsCard(MessageServer.MsgInfo msgInfo, int push_status);新增商品
/*
* goodsInfo 填写商品信息
* goods_list_cdn_url 商品列表 CDN 地址 用于快速更新列表
*/
ExamMessageCallBack.addGoodsInfo(GoodsInfoData.GoodsInfo goodsInfo, String goods_list_cdn_url);删除商品
/*
* del_goods_ids 删除或下架商品列表
* goods_list_cdn_url 商品列表 CDN 地址 用于快速更新列表
*/
ExamMessageCallBack.deleteGoods(List<String> del_goods_ids, String goods_list_cdn_url);更新商品信息
/*
* goodsInfo 填写商品信息
* goods_list_cdn_url 商品列表 CDN 地址 用于快速更新列表
*/
ExamMessageCallBack.updateGoodsInfo(GoodsInfoData.GoodsInfo goodsInfo,String goods_list_cdn_url);更新商品列表
/*
* goods_list_cdn_url 商品列表 CDN 地址 用于快速更新列表
*/
ExamMessageCallBack.updateGoodsList(String goods_list_cdn_url);订单状态改变
/*
* orderInfo 订单信息
*/
GoodsMessageCallBack.orderStatusChange(OrderInfoData orderInfo);