Skip to content

邀请榜列表

历史版本

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://gateway.nuoyunapi.com/Api/RoomStat/GetRoomInviteList/2.0.0
  • 频率限制:10秒1000次

请求参数

参数必选类型描述
room_idinteger直播间id
pageinteger页码,从1开始
page_sizeinteger每页条数,最大100

请求示例

json
{
    "room_id": 10001,
    "page": 1,
    "page_size": 10
}

响应参数

参数必选类型描述
codenumber状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
invite_listarray榜单列表
totalinteger总条数

invite_list 参数结构

参数必选类型描述
invite_idinteger邀请id
invite_numinteger邀请人数
wechat_user_space_idinteger用户id
namestring昵称
photostring头像
third_wechat_infoobject第三方微信信息

third_wechat_info 参数结构

参数必选类型描述
third_uuidstring第三方uuid
third_openidstring第三方openid

响应示例

json
{
  "code": 200,
  "data": {
    "invite_list": [
      {
        "invite_id": 100001,
        "invite_num": 5,
        "wechat_user_space_id": 10000001,
        "name": "邀请达人1",
        "photo": "https://example.oss.aliyuncs.com/uploads/avatar/user001.jpg",
        "third_wechat_info": {
          "third_openid": "oABCDEF123456789",
          "third_uuid": "uuid123456789abc"
        }
      },
      {
        "invite_id": 100002,
        "invite_num": 3,
        "wechat_user_space_id": 10000002,
        "name": "邀请达人2",
        "photo": "https://example.oss.aliyuncs.com/uploads/avatar/user002.jpg",
        "third_wechat_info": {
          "third_openid": "oABCDEF987654321",
          "third_uuid": "uuid987654321def"
        }
      }
    ],
    "total": 8
  },
  "msg": "Success"
}

状态码说明

状态码描述
200成功
400失败
-1参数错误