设置成员角色

设置成员角色

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

接口说明

接口英文名

getRoleListdw

功能描述

调用此接口设置小程序直播成员的管理员、运营者和主播角色。

调用方式

HTTPS 调用

POST https://api.weixin.qq.com/wxaapi/broadcast/role/addrole?access_token=ACCESS_TOKEN 

云调用

• 出入参和HTTPS调用相同，调用方式可查看云调用说明文档
• 接口方法为: openapi.liveBroadcast.addRole

第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同
• 该接口所属的权限集id为：52
• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

请求参数含义

参数	类型	必填	说明
username	String	是	用户的微信号
role	Number	是	设置用户的角色

返回参数含义

参数	说明
codeurl	如果主播未实名认证，需要先前往“小程序直播”小程序进行实名验证, 点击查看小程序二维码链接

调用示例

示例说明: HTTPS请求示例

请求数据示例

{
    username: 'test_1', // 微信号
    role: 1, // 取值[1-管理员，2-主播，3-运营者]，设置超级管理员将无效
} 

返回数据示例

{
    "errcode": 0,
    "errmsg": "ok"
} 

错误码

错误码	错误码取值	解决方案
40001	invalid credential access_token isinvalid or not latest	获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口
400001	微信号不合规
400002	微信号需要实名认证，仅设置主播角色时可能出现
400003	添加角色达到上限（管理员10个，运营者500个，主播500个）
400004	重复添加角色
200002	参数错误