用户列表
1 功能说明
根据用户邮箱获取用户信息
2 接口调用说明
2.1 URL
http://yourdomain.kf5.com/api/v1/user/view
2.2 格式
JSON
2.3 HTTP请求方式
GET, POST
2.4 IP限制
无
2.5 输入参数说明
参数名称 | 是否必须 | 类型 | 描述 |
username | 是 | string | 用户帐号 |
2.6 请求示例
http://yourdomain.kf5.com/api/v1/user/view?username=your@126.com&sign=12d45c66523dd069d7c64c22fea10f34
2.7 返回参数说明
参数名称 | 说明 |
err | 返回码。0:执行成功,1:有错误 |
msg | 如果错误,返回错误信息。 |
datas | 返回数据 |
id | 用户ID编号 |
username | 用户邮箱 |
name | 昵称 |
role | 角色 |
organization_id | 所属组织编号 |
photo | 头像 |
phone | 电话 |
details | 详细信息 |
notes | 注释 |
signature | 用户签名 |
status | 帐号状态 |
field_xxx | 用户自定义字段(后缀代表用户自定义字段的编号)高级版拥有此功能 |
2.8 正确返回示例
Content-type: text/html; charset=utf-8
{
"err":0,
"msg":""
"user":{
"username":"your@126.com",
"name":"\u6d4b\u8bd5\u63d0\u4ea4\u7684\u65b0\u5de5\u5355",
"role":"agent",
...
}
}
2.9 错误返回示例
Content-type: text/html; charset=utf-8
{
"err":1,
"msg":"用户不存在"
}
3 备注
无