修改账号积分打赏设置

接口URL

http://api.polyv.net/live/v3/channel/donate/update-point

接口说明

1、接口用于设置账号通用设置的积分打赏
2、通用参数通过普通url参数传递(timestamp, appId, sign),设置打赏参数的json通过请求体的方式传递
3、接口支持https

支持格式

JSON

请求方式

POST

请求参数

带在url后面

参数名
必选
类型
说明

appId

string

从API设置中获取,在直播系统登记的appId

timestamp

long

13位当前时间戳

sign

String

签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据【详见签名生成规则

请求体传参

参数名
必选
类型
说明

donatePointEnabled

string

积分打赏开关,取值Y/N

queryPointUrl

string

获取观众积分打赏接口

updatePointUrl

string

修改观众积分打赏接口

requestFailTips

string

请求失败提示

pointNotEnoughTips

string

积分不足提示

pointUnit

string

积分单位

goods

object[]

积分打赏的道具列表

goodName

string

道具名称,不能超过5个字符

goodImg

string

道具图片,不能超过120个字符(图片地址可以使用默认地址,或者通过上传图片接口上传获取图片地址)

goodPrice

double

道具打赏价格

goodEnabled

string

道具开关,值为 Y/N , Y为开启

注:这里的channelId,appId,timestamp,sign必须通过url传参,json数据通过请求体传参,如: http://api.polyv.net/live/v3/channel/donate/update-point?appId={{appId}}&timestamp={{timestamp}}&sign={{sign}}

请求体json拼接

响应成功JSON示例:

响应失败JSON示例:

#参数错误

#未输入appId

#appId不正确

#时间戳错误

#签名错误

#json为空或者json解析错误

#json中的goods数量限制

#json中的goods的名称字符限制

#json中的goods的图片地址字符限制

#json中的goods的价格数据类型错误

字段说明

参数名
说明

code

状态码,成功为200,签名失败为403,参数错误为400,服务端错误为500

status

成功为success,错误时为error

message

成功为"",错误时为错误描述信息

data

暂无作用

java请求示例

php请求示例

Last updated

Was this helpful?