团队管理
获取团队信息
GET /open_api/v1/me
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
email_search | 否 | string | 搜索邮箱关键字 |
phone_search | 否 | string | 搜索手机号关键字 |
ids_search | 否 | Integer | 搜索用户ID关键字 |
返回结果(data中的内容):
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
id | 是 | Integer | 团队ID |
name | 是 | String | 团队名称 |
否 | String | 账号邮箱 | |
phone | 否 | String | 账号手机号 |
left_quota | 否 | String | 剩余场次 |
members_count | 否 | Boolean | 团队成员数量 |
members | 否 | Array | 团队成员 |
例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"id": 1,
"name": "测试团队",
"email": "test@example.com",
"phone": "15111111111",
"left_quota": 100,
"members_count": 34,
"members": [{
"id": 6,
"name": "test"
}]
}
}
}
从其他团队划转场次
PUT /open_api/v1/transfer_team_bank
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
from_team_client_id | 是 | String | 划转团队的应用 Key |
from_team_token | 是 | String | 将划转团队的 应用 key 和 应用 secret 用 : 拼接,进行base64后去除换行符\n得到字符串token,即token = base64("username:password").replace("\n", "") |
from_team_id | 是 | String | 划转团队ID,从这个团队划转场次到自己团队下 |
quota | 是 | String | 划转场次数量,需确保划转团队场次余额不低于50场 |
返回结果(data中的内容):
例:
{
"errcode": 0,
"errmsg": "请求成功",
"data": "场次划转成功"
}
创建团队成员
POST /open_api/v1/team_members
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
uid | 是 | String | 唯一uid |
name | 是 | String | 面试官名字 |
否 | String | 面试官邮箱,邮箱与手机号必须有一个不为空 | |
phone | 否 | String | 面试官手机号,邮箱与手机号必须有一个不为空 |
team_role | 否 | String | 成员角色权限, 默认是normal, 参数值: normal、senior、reviewer, 分别对应的是:面试官、高级面试官、评卷官角色 |
返回结果(data中的内容):
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
id | 是 | Integer | 用户ID |
name | 是 | String | 面试官名称 |
否 | String | 邮箱 | |
phone | 否 | String | 手机号 |
例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"id": 1001,
"name": "李四",
"email": null,
"phone": null
}
}
删除团队成员
DELETE /open_api/v1/team_members/:user_id
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
user_id | 是 | String | 用户 ID, 可通过查看团队信息接口查看用户ID |
例:
{
"errcode": 0,
"errmsg": "删除成功"
}
获取控制台链接
GET /open_api/v1/console_link
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
user_id | 否 | Integer | 登录用户id,默认登录团队管理员 |
console_type | 否 | String | 控制台类型,interview,exam,custom;默认面试 interview |
return_to | 否 | string | 重定向地址,console_type为custom的时候传入 |
返回结果(data中的内容):
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
url | 是 | String | 免登控制台链接 |
例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"url": "https://www.showmebug.com/xxxxxxxx"
}
}
获取登录验证token
POST /open_api/v1/token
请求参数:
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
user_id | 否 | Integer | 登录用户id,默认登录团队管理员 |
返回结果(data中的内容):
参数名 | 必填 | 参数类型 | 描述 |
---|---|---|---|
token | 是 | String | 验证token |
expire_in | 是 | Integer | 过期时间,单位秒 |
例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"token": "AJSASDJLKAKFASHF1H",
"expire_in": 7200
}
}