添加频道商品库商品
接口地址(仅做说明使用):https://api.polyv.net/live/v3/channel/product/add
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、当商品类型为普通商品时,商品名称、商品封面链接、商品实际价格、商品上下架状态、商品链接类型必传,并根据商品链接类型传入对应链接
3、当商品类型为金融商品时,商品名称、商品上下架状态、商品链接类型必传,并根据商品链接类型传入对应链接
@Test
public void testAddChannelProduct() throws IOException, NoSuchAlgorithmException {
LiveAddProductRequest liveAddProductRequest = new LiveAddProductRequest();
LiveAddProductResponse liveAddProductResponse;
try {
liveAddProductRequest.setChannelId(createChannel())
.setName("测试添加金融产品1")
.setProductType("finance")
.setStatus(1)
.setLinkType(11)
.setPcLink("http://polyv.net")
.setMobileLink("http://polyv.net")
.setMobileAppLink("http://polyv.net")
.setWxMiniProgramLink("pages/home/index.html")
.setWxMiniProgramOriginalId("xxxxxxx")
.setYield("88")
.setFeatures("[\"tab1\", \"tab2\", \"tab3\", \"tab4\"]")
.setBtnShow("立即了解")
.setProductDesc("测试描述")
.setParams("{\"code\":123,\"color\":\"red\"}");
liveAddProductResponse = new LiveChannelProductServiceImpl().addChannelProduct(liveAddProductRequest);
Assert.assertNotNull(liveAddProductResponse);
if (liveAddProductResponse != null) {
log.debug("测试添加频道商品成功 {}", JSON.toJSONString(liveAddProductResponse));
}
} catch (PloyvSdkException e) {
//参数校验不合格 或者 请求服务器端500错误,错误信息见PloyvSdkException.getMessage()
log.error(e.getMessage(), e);
// 异常返回做B端异常的业务逻辑,记录log 或者 上报到ETL 或者回滚事务
throw e;
} catch (Exception e) {
log.error("SDK调用异常", e);
throw e;
}
}
1、请求正确,返回LiveAddProductResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
商品链接,链接地址长度为1-500:请求参数linkType=10时,该参数必填,当请求参数linkType=11时,该参数为非必填
多平台链接,pc端跳转链接,链接地址长度为1-500:请求参数linkType=10时,该参数非必填,当请求参数linkType=11时,该参数必填
多平台链接,小程序内页面路径及参数(对于path属性,所声明的页面路径必须添加.html后缀,如pages/home/index.html)【对应api文档的wxMiniprogramLink字段】
多平台链接,小程序端原始Id【对应api文档的wxMiniprogramOriginalId字段】
自定义参数,类型json对象,需要转为string
产品特色,卖点标签,可以多个,json字段,如:["tab1", "tab2"]
普通商品参数,商品封面链接,商品类型为普通商品时必传,长度范围:1-500
普通商品参数,商品实际价格,商品类型为普通商品时必传,保留两位小数,如:0.01
普通商品参数,商品原价,保留两位小数,如:0.01
商品类型,默认为普通商品:normal:普通商品,finance:金融商品
POLYV用户ID,和保利威官网一致,获取路径:官网->登录->直播(开发设置)
普通商品参数,商品原价,保留两位小数,如:0.01
多平台链接,小程序端跳转链接【对应api文档的wxMiniprogramLink字段】
多平台链接,小程序端原始Id【对应api文档的wxMiniprogramOriginalId字段】
自定义参数,类型json对象,需要转为string
商品类型,normal:普通商品,finance:金融商品
产品特色,卖点标签,可以多个,json字段,如:["tab1", "tab2"]
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、当商品类型为普通商品时,商品名称、商品封面链接、商品实际价格、商品上下架状态、商品链接类型必传,并根据商品链接类型传入对应链接
3、当商品类型为金融商品时,商品名称、商品上下架状态、商品链接类型必传,并根据商品链接类型传入对应链接
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
通用链接,商品链接,长度1-500,当linkType=10时,该参数必填;当请求参数linkType=11时,该参数无效
多平台链接,pc端跳转链接,长度1-500 当请求参数linkType=11时,该参数必填;当请求参数linkType=10时,该参数无效
多平台链接,小程序内页面路径及参数(对于path属性,所声明的页面路径必须添加.html后缀,如pages/home/index.html)【对应api文档的wxMiniprogramLink字段】
多平台链接,小程序端原始Id【对应api文档的wxMiniprogramOriginalId字段】
自定义参数,类型json对象,需要转为string
产品特色,卖点标签,可以多个,json字段,如:["tab1", "tab2"]
商品类型,默认为普通商品:normal:普通商品,finance:金融商品
null
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回LiveGetProductEnabledResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回LiveGetProductListResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
当前页【对应api文档的pageNumber字段】
总页数【对应api文档的totalPages字段】
channelProductList参数描述
POLYV用户ID,和保利威官网一致,获取路径:官网->登录->直播(开发设置)
创建商品时间,格式:yyyy-MM-dd HH:mm:ss
更新商品时间,格式:yyyy-MM-dd HH:mm:ss
多平台链接,小程序端跳转链接【对应api文档的wxMiniprogramLink字段】
多平台链接,小程序端原始Id【对应api文档的wxMiniprogramOriginalId字段】
自定义参数,类型json对象,需要转为string
商品类型,normal:普通商品,finance:金融商品
产品特色,卖点标签,可以多个,json字段,如:["tab1", "tab2"]
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为修改成功,false为修改失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为修改成功,false为修改失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、仅商品为上架状态才可进行推送
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为推送成功,false为推送失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、排序在第一位不能上移操作,最后一位不能下移
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
type为50时必传,移动到的指定位置(范围:1~商品总数)
true为修改成功,false为修改失败
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.LivexxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为删除成功,false为删除失败