帮助中心

用户管理

目录

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 用户头像网络路径

响应参数

返回形如 {“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 邮箱格式不对
10077 密码不能为空
10078 密码为6-20位
10079 该邮箱已存在

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 更新邮箱
head string 更新头像网络路径

响应参数

返回形如 {“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 密码为6-20位
10079 该邮箱已存在
10080 账户信息存在

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

获取微吼用户ID

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

请求参数

参数名 类型 必选 说明
third_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值的数据类型如下:

类型 说明
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 分配量
role_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值的数据类型如下:

响应示例

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

错误码

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

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 子账号信息不存在

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天

响应参数

参数名 类型 必选 说明
remain_flowstring剩余流量
total_flowstring使用总流量
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 不属于自己的账号或子账号