帮助中心

用户管理

目录

user/register 创建用户

创建用户

URL http://e.vhall.com/api/vhallapi/v2/user/register

请求参数

参数名类型必选说明
third_user_id string 第三方用户ID,做为SDK DEMO里的帐号
pass string 用户密码,做为SDK DEMO里的密码
phone string 用户手机号
name string 用户昵称
email string 用户邮箱
head string 用户头像网络路径
local_head file 本地头像
customized_fieldstring API用户自己定义的一个字段,长度小于255个字符
customized_valuestring 上述自定义字段的值

响应参数

返回形如 {“code”:200,”msg”:“success”,”data”:{“user_id”:“799”}}的json,data值的数据格式如下

参数名类型必选说明
user_id int 微吼用户ID

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "user_id": "799"
    }
}

错误码

code含义
10070 第三方用户ID不能为空
10073 手机格式不对
10074 该手机号已存在
10021 邮箱格式不对
10077 密码不能为空
10078 密码为6-20位
10079 该邮箱已存在
10833 自定义字段过长
10834 自定义值过长

user/update 更新用户

更新用户

URL http://e.vhall.com/api/vhallapi/v2/user/update

请求参数

参数名类型必选说明
third_user_id string 第三方用户ID
pass string 更新密码
phone string 更新手机号
name string 更新昵称
email string 更新邮箱
wbinar_id int 更新当前活动用户的参会信息
head string 更新头像网络路径
local_head file 本地头像
customized_fieldstring API用户自己定义的一个字段,长度小于255个字符
customized_valuestring 上述自定义字段的值

响应参数

返回形如 {“code”:200,”msg”:“success”,”data”:{“user_id”:“799”}}的json,data值的数据格式如下

参数名类型必选说明
user_id int 微吼用户ID

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "user_id": "799"
    }
}

错误码

code含义
10070 第三方用户ID不能为空
10073 手机格式不对
10074 该手机号已存在
10076 邮箱格式不对
10078 密码为4-32位
10079 该邮箱已存在
10080 账户信息存在
10833 自定义字段过长
10834 自定义值过长

user/get-user-id 获取微吼用户ID

获取微吼用户ID

URL http://e.vhall.com/api/vhallapi/v2/user/get-user-id 

请求参数

参数名 类型 必选 说明
third_user_id string 第三方用户ID

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:[{“start_time”:“2016-09-21 15:05:21”,”num”:30},{“start_time”:“2016-09-07 13:58:27”,”num”:1}]}的json。data值的数据类型如下:

类型 说明
id 微吼用户ID

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": 837
  }
}

错误码

code 含义
10102 第三方用户ID不能为空
10103 第三方用户对象不存在

user/change-user-power 更改用户权限

更改第三方账号权限

URL http://e.vhall.com/api/vhallapi/v2/user/change-user-power 

请求参数

参数名 类型 必选 说明
user_id int 用户id
is_child int 是否是子帐号 1是 0不是
assign int 分配量,父账号是流量套餐时单位为(G)且可支持小数点后两位,父账号是并发套餐时单位为(人)仅支持整数

如需要用户具有直播权限,is_child请传1,assign大于0或在子账号管理中的用量分配方式修改为“动态”。

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:[{“start_time”:“2016-09-21 15:05:21”,”num”:30},{“start_time”:“2016-09-07 13:58:27”,”num”:1}]}的json。data值的数据类型如下:

响应示例

{
  "code": 200,
  "msg": "success",
  "data": []
}

错误码

code 含义
10102 用户ID不能为空
10103 第三方用户对象不存在
10104 子账号信息不存在
10105 分配量不能超过可用量
10106 子账号类型不对
10107 分配量不能为空
10108该认证用户未开通子账号权限
10830非第三方用户不能更改子账号选项

user/get-user-power 获取用户权限

获取用户权限

URL http://e.vhall.com/api/vhallapi/v2/user/get-user-power 

请求参数

参数名 类型 必选 说明
user_id int 用户ID

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:[{“start_time”:“2016-09-21 15:05:21”,”num”:30},{“start_time”:“2016-09-07 13:58:27”,”num”:1}]}的json。data值的数据类型如下:

is_child 是否是子账号 0 不是 1 是
assign 分配用量
role_id 角色ID

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "is_child": 1,
    "assign": "10",
    "role_id" : 1
  }
}

错误码

code 含义
10102 用户ID不能为空
10103 第三方用户对象不存在
10104 子账号信息不存在
10831 当前查询数据非子账号数据拥有者

user/get-child-list 获取子账号列表

获取子账号列表

URL http://e.vhall.com/api/vhallapi/v2/user/get-child-list

请求参数

参数名 类型 必选 说明
source int 子账号创建来源,1为从微吼平台创建,2为通过接口创建,默认获取全部
pos int 数字,设置从第几条数据开始获取,如果是第一条数据(pos=0),默认为0
limit int 数字,每次返回条数

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:{}}的json。data部分数据如下:

参数名 类型 说明
user_id int 子账号的微吼用户id
source int 1为从微吼平台创建,2为通过接口创建
res_type int 用量类型,1为流量,2为并发
assign_mode int 用量分配方式,1为固定,2为动态
assign float 具体分配的并发或流量数,如assign_mode是2则不返回此参数
third_user_id string 第三方用户id

响应示例

{
      "code": "200",
      "msg": "成功",
      "data": [
          {
              "user_id": 981,
              "name": "xxxx",
              "source": 2,
              "res_type": 1,
              "assign_mode": 1,
              "assign": 0
          },
          {
              "user_id": 982,
              "name": "木木的子账号",
              "source": 2,
              "res_type": 1,
              "assign_mode": 1,
              "assign": 50
          }
      ]
  }

错误码

code说明
10819 无子账号数据
10820 当前主账号不是会员

user/get-user-info 获取用户信息

获取用户信息,支持获取接口创建的用户以及微吼平台添加的子账号

URL http://e.vhall.com/api/vhallapi/v2/user/get-user-info

请求参数

参数名类型必选说明
user_id string 微吼用户id
fields string 需要获取的字段,字段之间用英文逗号,分割

fields 参数详情

字段名 说明
name string 用户昵称
head string 用户头像的网络路径
customized_field string 第三方用户创建接口中传入的字段
third_user_id string 第三方用户id

响应参数

返回形如 { “code”: “200”, “msg”: “成功”, “data”: {} }的json。data部分数据如下:

参数名类型说明
name string 用户昵称
head string 用户头像的网络路径,不传则返回微吼默认头像地址
customized_field string API用户自己定义的一个字段,长度小于255个字符
customized_value string 上述自定义字段的值

响应示例

  {
      "code": "200",
      "msg": "成功",
      "data": {
          "name": "xxxx",
          "head": "",
          "customized_field": "",
          "customized_value": ""
      }
  }

错误码

code说明
10103 第三方用户对象不存在

user/use-flow 用户流量查询

统计账号的流量

URL http://e.vhall.com/api/vhallapi/v2/user/use-flow 

请求参数

参数名 类型 必选 说明
user_id int 用户id
time_span int 时间跨度 1⇒ 7天,2 ⇒ 30天,3 ⇒ 90天,4 ⇒ 180天,5 ⇒: 360天
begintime date 标准时间格式,例:2017-7-12 10:12:11,当type为1是为必填项
endtime date 标准时间格式,例:2017-7-22 10:12:11,当type为1是为必填项
type int 默认值为0,当type为1时使用通过begintime-endtime时间段查询,时间范围不能超过一年

响应参数

参数名 类型 必选 说明
remain_flowstring剩余流量
total_flowstring直播使用总流量
total_record_flow string 回放消耗的总流量
select_total_flow string 查询时间段内直播使用总流量
select_total_record_flow string 查询时间段内回放消耗的总流量

list数据

参数名 类型 必选 说明
date string 时间
live_flow string 直播消耗流量
record_flow string 回放消耗流量

响应示例

{
    "code":"200",
    "msg":"成功",
    "data":{
        "remain_flow":98.78,
        "total_flow":6.28,
        "total_record_flow":0,
        "list":[
            {
                "date":"2017-01-09",
                "live_flow":0.12,
                "record_flow":0
            },
            {
                "date":"2017-01-08",
                "live_flow":0.04,
                "record_flow":0
            },
            {
                "date":"2017-01-06",
                "live_flow":0.02,
                "record_flow":0
            },
            {
                "date":"2017-01-05",
                "live_flow":1.04,
                "record_flow":0
            }
        ]
    }
}

错误码

code 含义
10060 用户ID不能为空
10116 time_span 参数不能为空
10060 不是自己的活动
10117 不属于自己的账号或子账号
12201 当type为1时,开始时间不能为空
12202 开始时间格式错误
12203 当type为1时,结束时间不能为空
12204 结束时间格式错误
12205 开始时间不能大于结束时间

user/bind-manager 主账号绑定第三方账号

主账号绑定第三方账号

URL http://e.vhall.com/api/vhallapi/v2/user/bind-manager 

请求参数

参数名 类型 必选 说明
third_user_id string 第三方用户ID,做为SDK DEMO里的帐号
pass string 用户密码,做为SDK DEMO里的密码
is_cover int 是否覆盖替换原有绑定的账号,传递1为覆盖,其他为不覆盖

响应参数

返回形如 {“code”:200,”msg”:“success”,”data”:{“user_id”:“799”}}的json,data值的数据格式如下

参数名类型必选说明
user_id int 微吼用户ID

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "user_id": "799"
    }
}

错误码

code含义
10070 第三方用户ID不能为空
10077 密码不能为空
10078 密码为6-20位
12003 绑定主账号失败
12004 主账号已经被其他第三方账号绑定
12013 第三方账号已经注册微吼账号,请换一个未注册微吼账号的第三方账号来绑定主账号

user/manager-bind-info 查询主账号绑定的第三方账号

主账号绑定第三方账号

URL http://e.vhall.com/api/vhallapi/v2/user/manager-bind-info 

请求参数

响应参数

返回形如 {“code”:200,”msg”:“success”,”data”:{“user_id”:“799”}}的json,data值的数据格式如下

参数名类型必选说明
account_id string 第三方账号信息

响应示例

{
    "code":200,
    "msg":"success",
    "data":{
        "account_id":"testuser"
    }
}

错误码

code含义
12011 主账号未绑定第三方账号,请绑定后重新查询

user/concurrent-audience 查询用户直播场次并发数据

查询用户直播场次并发数据

URL http://e.vhall.com/api/vhallapi/v2/user/concurrent-audience 

请求参数

参数名 类型 必选 说明
user_id int 用户id
begintime date 标准时间格式,例:2017-7-12 10:12:11
endtime date 标准时间格式,例:2017-7-22 10:12:11

响应参数

返回形如{“code”:“200”,”msg”:“\u6210\u529f”,”data”:[{“user_id”:884,”webinar_id”:580997031,”subject”:“\u5b59\u632f\u4eae\u6d4b\u8bd5\u591a\u5609\u5bbe”,”num”:4,”start_time”:“2017-05-26 23:54:30”}]}的json。data部分数据如下:

参数名 类型 必选 说明
user_id int 用户id
webinar_id int 活动ID
subject string 活动主题
num int 并发值
start_time datetime 活动开始时间

响应示例

{
    "code": "200", 
    "msg": "成功", 
    "data": [
        {
            "user_id": 888, 
            "webinar_id": 580911111, 
            "subject": "xxxxxxx", 
            "num": 3, 
            "start_time": "2017-05-26 22:48:49"
        }
    ]
}

错误码

code 含义
10060 用户ID不能为空
10117 不属于自己的账号或子账号
10104 子账号信息不存在
12301 开始时间不能为空
12302 开始时间格式错误
12303 结束时间不能为空
12304 结束时间格式错误
12305 开始时间不能大于结束时间
12306 查询时间范围不能超过1年

user/concurrent-date 查询用户每天并发数

查询用户每天并发数

URL http://e.vhall.com/api/vhallapi/v2/user/concurrent-date 

请求参数

参数名 类型 必选 说明
user_id int 账号id
begintime date 标准时间格式,例:2017-7-12 10:12:11
endtime date 标准时间格式,例:2017-7-22 10:12:11

响应参数

返回形如{“code”:“200”,”msg”:“\u6210\u529f”,”data”:{“2017-07-29”:0,”2017-07-30”:0,”2017-07-31”:0,”2017-08-01”:150,”2017-08-02”:0}}的json。data部分数据如下:

参数名 类型 必选 说明
json 获取成功,返回列表数据(JSON格式),包含时间对应的并发数

响应示例

{
    "code": "200", 
    "msg": "成功", 
    "data": {
        "2017-07-29": 0, 
        "2017-07-30": 0, 
        "2017-07-31": 0, 
        "2017-08-01": 150, 
        "2017-08-02": 0
    }
}

错误码

code 含义
10060 用户ID不能为空
10117 不属于自己的账号或子账号
12301 开始时间不能为空
12302 开始时间格式错误
12303 结束时间不能为空
12304 结束时间格式错误
12305 开始时间不能大于结束时间
12306 查询时间范围不能超过1年