接口URL
http://api.polyv.net/live/v3/channel/chat/send-product-msg
接口说明
(接口调用有频率限制，详细请查看)
1、发送聊天室socket商品信息
2、接口支持https
3、接口请求频次限制为每分钟30次
返回结果支持格式
JSON
请求方式
POST
请求数限制
TRUE
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 从API设置中获取，在直播系统登记的appId |
| timestamp | 是 | long | 当前13位毫秒级时间戳，3分钟内有效 |
| sign | 是 | string | 签名，为32位大写的MD5值 |
| channelId | 是 | int | 频道号 |
| status | 是 | int | 操作类型，必须为整型 1：上架商品 2：下架商品 3：删除商品 4：新增商品 5：编辑商品 6：上移 7：下移 目前这个status可以自定义，0-20为平台参数，21及其以上客户可自定义 |
请求体信息
// 如下json，只有发送这种指定类型的json数据，polyv平台观看页才可以响应数据
// 如果发送其他自定义格式，需要自己开发观看页，接收到改socket 消息时自行进行处理。
// 请求体长度限制1000字符，如果超过，会返回错误。
// 新增、编辑、上架
{
"cover": "//liveimages.videocc.net/uploadimage/20200805/chat_img_1851013_15966102016428.jpeg?x-oss-process=image/crop,x_625,y_267,w_668,h_668",
"link": "http://www.msuno.cn",
"name": "123",
"price": 21,
"productId": 5324,
"rank": 2,
"realPrice": 12,
"status": 1
}
// 下架（商品Id）
{
"productId": 5324
}
// 上移、下移（两个商品移动的id和排序和状态）
[
{
"productId": 5321,
"rank": 2,
"status": 1
},
{
"productId": 5324,
"rank": 1,
"status": 2
}
]
响应成功JSON示例：
{
"code": 200,
"status": "success",
"message": "",
"data": true
}
响应失败JSON示例：
未输入appId
{
"code": 400,
"status": "error",
"message": "appId is required.",
"data": ""
}
appId不正确
{
"code": 400,
"status": "error",
"message": "application not found.",
"data": ""
}
时间戳错误
{
"code": 400,
"status": "error",
"message": "invalid timestamp.",
"data": ""
}
签名错误
{
"code": 403,
"status": "error",
"message": "invalid signature.",
"data": ""
}
频道号格式错误
{
"code": 400,
"status": "error",
"message": "param is not digit: dsadasd",
"data": ""
}
请求体为空
{
"code": 400,
"status": "error",
"message": "param should not be empty: msg",
"data": ""
}
请求体数据过长
{
"code": 400,
"status": "error",
"message": "param length is incorrect: 1000",
"data": ""
}
字段说明
| 参数名 | 说明 |
|---|---|
| code | 响应代码，成功为200，失败为400，签名错误为401，异常错误500 |
| status | 成功为success，失败为error |
| message | 错误时为错误提示消息 |
| data | 暂无作用，不可作为判断依据 |
Java请求示例
public static void main(String[] args) {
String url = "http://api.polyv.net/live/v3/channel/chat/send-product-msg";
// 用户对应的appId和加密串
String appId = "xxxxxx";
String appSecret = "xxxxxxxxxxxxxxxxxxxxxxx";
// 查询频道号
String channelId = "1796673";
Map<String, String> params = new HashMap<>();
params.put("channelId", channelId);
params.put("status", "1");
// 调用Polyv的工具类方法设置sign
PolyvTool.setLiveSign(params, appId, appSecret);
// 调用Polyv的httpClient工具类发送请求
String content = HttpClientUtil.getInstance()
.sendHttpPostJson(url + "?" + PolyvTool.mapJoinNotEncode(params), "json请求体", null);
System.out.println(content);
}
签名规则(PolyvTool.java文件代码查看)
https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/
Loading...