form.getuserinfo
功能说明
描述
获取用户的详细信息。
函数原型
form.getuserinfo(userids,type=0,bErr=True)
复制
参数
名称 | 类型 | 描述 |
---|---|---|
userids | 字符型/数组:列表型 | 用户成员id(id在通讯录"成员设置"中查看),此参数可以为字符串或者数组;为字符串的情况下,直接返回当前用户的信息;为数组的情况下,同时查询多个符号条件的多个用户的信息,以二维数据的方式返回 |
type | 整型 | 指定userids的类型 0表示是userid 1表示是企业内用户id 2表示是用户的手机号码 3表示是团队姓名 |
bErr | 逻辑型 | 在userids为数组的情况下才生效,True表示遇到错误立即返回,False表示继续执行(此时返回值里的错误userid将保留空数组) |
企业内用户id在通讯录里查看 |
---|
![]() |
返回值
类型 | 描述 |
---|---|
数组:字典型 | userids参数为字符串的时候返回指定用户信息,userids参数为数组的情况下,同时查询多个符合条件的多个用户的信息,以二维数据的方式返回,获取失败返回空数组 |
- 数据格式:
{
"category":0,
"remark":"bobo的备注",
"name":"bobo",
"title":"教授",
'maindept': {
'id': '51a46202e6c4839854bcb243',
'name': '部门1'
},
"dept":[
{
"ismanager":True,
"name":"部门1",
"id":"51a46202e6c4839854bcb243"
},
{
"id":"5c10d76b4e38a45800266",
"ismanager":False,
"name":"部门2",
"parent":{
"istop":False,
"manager":[
"5757ce7ca9f27cdee7cda6a3",
"5ee2198b9eae9aeaecf0b438"
],
"name":"开发部",
"id":"569b845d6fa928d1de40aeb4"
}
}
],
"jobtitle": [
{
"deptid": "5e8591f321dd595f7427f8c0",
"deptname": "人事部",
"title": "职称名称"
}
],
"phone":"137********",
"id":"5b68110f7cf2885b5e19e66a",
"innerid":"bb"
}
复制
- userids为[数组型]时的返回结果(如果type=3时团队姓名对应的用户存在多个则返回包含多个元素的列表):
{
"5b68110f7cf2885b5e19e66a":{
"name":"bobo",
"remark":"bobo的备注",
"id":"5b68110f7cf2885b5e19e66a",
"title":"教授",
"innerid":"bb",
"category":0,
'maindept': {
'id': '51a46202e6c4839854bcb243',
'name': '部门1'
},
"dept":[
{
"name":"abc2",
"ismanager":False,
"id":"59988c3f51325af8a75f301a",
"istop":True,
"parent":{}
}
],
"jobtitle": [
{
"deptid": "5e8591f321dd595f7427f8c0",
"deptname": "人事部",
"title": "职称名称"
}
],
"phone":"137********"
},
"547a48c50eccde5ac8c0883b":{
"name":"bobo2",
"remark":"bobo2的备注",
"id":"547a48c50eccde5ac8c0883b",
"title":"",
"innerid":"PiBaiJun",
"category":0,
'maindept': {
'id': '51a46202e6c4839854bcb243',
'name': '部门1'
},
"dept":[
{
"name":"abc2",
"ismanager":False,
"id":"59988c3f51325af8a75f301a",
"istop":True,
"parent":{}
}
],
"jobtitle": [
{
"deptid": "5e8591f321dd595f7427f8c0",
"deptname": "人事部",
"title": "职称名称"
}
],
"phone":"137********"
}
}
复制
名称 | 描述 |
---|---|
id | 用户/部门id |
name | 团队姓名 |
category | 用户状态(-1表示被邀请的人尚未同意其邀请,同意后自动变为2,0表示团队创建者,2表示普通成员) |
title | 用户的职称(旧职称字段已废弃) |
jobtitle | 用户的职称信息 |
innerid | 企业内用户id |
dept | 用户的父级部门信息 |
phone | 用户的手机号码 |
remark | 成员的备注信息 |
ismanager | True表示是当前的部门主管,False表示不是 |
parent | 部门的父级部门信息 |
istop | True表示为顶级部门 |
manager | 部门的主管信息(可能有多个主管) |
maindept | 主部门信息 |
备注
可能出现的错误信息,执行 getlasterror 函数获取具体详细信息:
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
错误编码 | 错误信息 |
---|---|
1407 | api执行频率超出限制 |
1400 | 参数类型不正确 |
1302 | 赋值失败 |
1506 | 连接数据库失败 |
1526 | 部门或成员id不能为空 |
1528 | 成员不存在 |
1533 | 数据库执行失败 |
其他:
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
# 查询单个用户信息
ret=form.getuserinfo("5ba0a4cefe5cfd97ba12a4c2")
print(ret)
# 查询多个用户信息
ret=form.getuserinfo(["5ba0a4cefe5cfd97ba12a4c2","5ba0a4cefe5cfd97ba12a4c3"])
print(ret)
复制
演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无
目录