直播间跳转商户自定义商品下单页面

说明

短训宝直播间支持关联商户自定义的商品下单页面。即：客户在直播间点击商品列表后，可以跳转到由商户自定义的商品下单页面。
为了实现 短训宝系统 与 本系统商户商品订单系统 的数据打通，在跳转到 由商户自定义的商品下单页面地址 之前，短训宝系统会自动在链接上携带一些参数。

携带参数

字段名	说明
userNum	邀请人id。邀请客户进入直播间的员工id。例如在调用推送订单接口时，应该将此参数值 赋值给inviteUserId传给短训宝。
unionId	客户的微信unionId
openId	客户的openId
nickname	UrlEncode之后的客户的昵称
avatar	UrlEncode之后的客户的头像
dxbs	短训宝与第三方系统打通参数。例如在调用推送订单接口时，应将此参数值传给短训宝。
dxbSkuId	短训宝商品编号。例如在调用推送订单接口时，应将此参数值传给短训宝。
tb	短训宝商户唯一ID。例如在调用推送订单接口时，可将此参数值 赋值给bizNum传给短训宝，用于多商户的场景。
customerNum	客户唯一编号
roomId	直播间ID

示例

自定义商品下单页面地址：http://yourdomain.com/item/200063616828.html
客户在直播间点击商品列表后，实际跳转地址：http://yourdomain.com/item/200063616828.html?userNum=rT2oxAwx92&unionId=123&openId=456&nickname=%E6%98%B5%E7%A7%B0&avatar=https%3A%2F%2Fwww.baijiayun.com%2Fvideo-cloud%2Fasset%2Ffrontend%2Fimg%2Fwechat_logo.png&dxbs=L_q92XlaPes5&dxbSkuId=20240228162652889&tb=ziqSnsoG8l&roomId=26042075349637

直播关联商品

接口说明

项	值
URL	/openapi/v1/live/addGoods.json
描述	直播关联商品
请求方式	POST
需要登录	是
注意事项	无
其他	无

请求参数说明

字段名	字段类型	说明	是否必传
liveId	string	直播id	是
goodsIds	List	商品id列表	是

请求数据

{
  "liveId":"111abc",
  "goodsIds":["123abc","456efg"]
}

返回数据

{
    "msg": "",
    "code": 200,
    "data": "",
    "pageDto": null
}

直播删除商品

接口说明

项	值
URL	/openapi/v1/live/deleteGoods.json
描述	直播删除商品
请求方式	POST
需要登录	是
注意事项	无
其他	无

请求参数说明

字段名	字段类型	说明	是否必传
id	string	唯一id	是

请求数据

{
  "id":"123abc"
}

返回数据

{
    "msg": "",
    "code": 200,
    "data": "",
    "pageDto": null
}

直播关联商品列表

接口说明

项	值
URL	/openapi/v1/live/goodsList.json
描述	直播点播视频列表
请求方式	POST
需要登录	是
注意事项	无
其他	无

请求参数说明

字段名	字段类型	说明	是否必传
liveId	string	直播id	是
pageDto	Object	分页对象	否

分页对象

字段名	字段类型	说明	是否必传
pageSize	number	页大小	是。区间 (0,100]
pageNum	number	页码	是。从1开始

请求数据

{
  "liveId":"123abc",
  "pageDto": {
    "pageNum": 1,
    "pageSize": 20
  }
}

返回数据

{
    "msg": "",
    "code": 200,
    "data": [
        {
            "id": "c4U1XXPxWy",
            "firstImgUrl": "https://bbbbb123.jpg",
            "title": "实物商品abc",
            "goodsId": "YUdL6UwySV",
            "productId": "202501031418273013",
            "detailUrl": "https://xxxxx",
            "description": "",
            "originPrice": null,
            "discountPrice": 100
        }
    ],
    "pageDto": {
        "count": 1,
        "curPageCount": null,
        "pageNum": 1,
        "pageSize": 20,
        "needCount": true,
        "offset": 0,
        "totalPageNum": 1
    }
}