获取跑马灯设置接口
更新时间:2022-09-02 18:08:07
接口URL
http://api.polyv.net/live/v3/channel/marquee/get
接口说明
1、接口用于获取频道或全局的跑马灯设置信息
2、接口支持https
3、不提交channelId 表示获取全局设置
4、提交channelId 且getActual="N" 表示获取频道本身的设置,不提交getActual 或者提交getActual = "Y" 表示获取频道实际生效的跑马灯设置
支持格式
JSON
请求方式
GET
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 管理员的appId |
| timestamp | 是 | long | 13位当前时间戳 |
| sign | 是 | String | 签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据【详见签名生成规则】 |
| userId | 是 | string | 用户id |
| channelId | 否 | int | 频道id,查询全局设置值不用传该值 |
| getActual | 否 | string(取值Y/N) | 仅在查询频道跑马灯设置时生效,Y:获取频道实际生效跑马设置,N:获取频道的跑马灯设置 |
响应成功JSON示例:
{
"code": 200,
"status": "success",
"message": "",
"data": {
"globalSettingEnabled": null,
"marqueeRestrict": "N",
"marqueeType": "nickname",
"marquee": "",
"marqueeOpacity": 100,
"marqueeFontSize": 30,
"marqueeFontColor": "#000000",
"marqueeAutoZoomEnabled": "N"
}
}
响应失败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": ""
}
用户ID错误
{
"code": 400,
"status": "error",
"message": "userId error.",
"data": ""
}
签名错误
{
"code": 403,
"status": "error",
"message": "invalid signature.",
"data": ""
}
字段说明
| 参数名 | 说明 |
|---|---|
| code | 响应代码,成功为200,失败为400,签名错误为403,异常错误500 |
| status | 成功为success,失败为error |
| message | 错误时为错误提示消息 |
| data.globalSettingEnabled | 频道跑马灯的全局设置开关,查询全局设置时此字段为null |
| data.marqueeRestrict | 跑马灯开关,取值Y(开),N(关) |
| data.marqueeType | 跑马灯类型,取值:fixed(固定值)、nickname(观众名称)、diyurl(自定义url) |
| data.marquee | marqueeType=fixed 时,此字段为跑马灯内容,marqueeType=nickname 为空, marqueeType=diyurl 为用户的url |
| data.marqueeOpacity | 跑马灯不透明度,范围是 0 ~ 100 |
| data.marqueeFontSize | 跑马灯字体大小 |
| data.marqueeFontColor | 跑马灯字体颜色,例如 #ffffff |
| data.marqueeAutoZoomEnabled | 是否开启跑马灯自适应缩放,值为 Y 或 N |
