Skip to content

查询用户列表

请求说明

请求头

参数名中文名称必须类型描述
Authorization授权String格式:Bearer {access_token}
Content-Type内容类型String固定值:application/json; charset=utf-8

请求示例

http
GET https://{your_domain}/api/v2/tenant/users?offset=0&limit=10

请求参数

参数名中文名称必须类型描述
offset分页页码Number从第0页开始
limit每页数量Number每页数量在10-100之间
updated_at_greater更新时间大于String根据更新时间过滤,更新时间在此之后的才会返回,格式为 yyyy-MM-dd HH:mm:ss
updated_at_less更新时间小于String根据更新时间过滤,更新时间在此之前的才会返回,格式为 yyyy-MM-dd HH:mm:ss

返回值示例

成功示例

HTTP/1.1 200 OK

JSON
{
	"total":2,
    "users":[
        {
			"user_name":"zhangsan",
			"user_id":"20220126153857263-A04D-60E0D446C",
			"name":"张三",
			"mobile":"15200000000",
			"email":"15200000000@qq.com",
			"pwd_change_at":"2022-02-15 12:23:23",
			"created_at":"2022-02-10 12:23:23",
			"updated_at":"2022-02-15 12:23:23",
			"disabled":false,
			"attr_gender":"male",
			"attr_birthday":"2022-02-17",
			"attr_nick_name":"张三",
			"mailing_address":"湖北省武汉市",
			"zip_code":"430000",
			"first_name":'',
			"middle_name":'',
			"last_name":'',
			"industry":"事业单位",
			"external_id":"12345678741d29069abcdef089d4q87sk12",
			"usr_auth_times":"4",
			"usr_last_login":"2022-02-17 13:00:25",
			"extension": {
				"age":"28"
			  },
            "head_img": "https://........"
		},
        {
			"user_name":"zhangsan",
			"user_id":"20220126153857263-A04D-60E0D446D",
			"name":"张三",
			"mobile":"15200000000",
			"email":"15200000000@qq.com",
			"pwd_change_at":"2022-02-15 12:23:23",
			"created_at":"2022-02-10 12:23:23",
			"updated_at":"2022-02-15 12:23:23",
			"disabled":false,
			"attr_gender":"male",
			"attr_birthday":"2022-02-17",
			"attr_nick_name":"张三",
			"mailing_address":"湖北省武汉市",
			"zip_code":"430000",
			"first_name":'',
			"middle_name":'',
			"last_name":'',
			"industry":"事业单位",
			"external_id":"12345678741d29069abcdef089d4q87sk16",
			"usr_auth_times":"4",
			"usr_last_login":"2022-02-17 13:00:25",
			"extension": {
				"age":"28"
			  },
            "head_img": "https://........"
		}
    ]
}

返回参数

参数名中文名称类型描述
user_name用户名String
user_id用户IDString
name姓名String
mobile手机号String
email邮箱String
pwd_change_at密码修改时间String
created_at用户创建时间String
updated_at用户修改时间String
disabled是否已禁用String
attr_gender性别String"unknow":保密 "male":男 "female":女
attr_birthday生日String格式为: yyyy-mm-dd
attr_nick_name昵称String
mailing_address邮寄地址String
zip_code邮政编码String
first_name名字String
middle_name中间名String
last_name姓氏String
industry所属行业String
external_id外部IDString
usr_auth_times登录次数Number
usr_last_login最后登录时间String
extension扩展属性JSONObject
head_img用户头像urlString

错误码

状态码错误码中文错误信息英文错误信息处理措施
400IDAAS.TENANT.PAGE.0001每页数量不符合校验规则The number of pages does not meet the verification rules请重新输入每页数量

竹云IDaaS开放平台