获取用户通行证列表(包含用户参数工号)

请求参数

Query 参数

pageIndex

integer

可选

页码。当前页下标，可空，默认值1，最小值1。

示例值:

1

pageSize

integer

可选

每页数。可空，默认值100，最小值1，最大值4000。

示例值:

10

updateTime

integer

可选

更新时间。毫秒级时间戳，查询大于或等于更新时间的用户，每次请求取上次请求返回的最大更新时间，如果没有就传0，当前请求更新时间不变，页码依次加1。

示例值:

1684809452768

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

jwt凭证

必需

示例值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'http://prod-cn.your-api-server.com/api/open/enterpriseright/user-manage/v1/user/list?pageIndex=1&pageSize=10&updateTime=1684809452768&project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI' \
--header 'Authorization;'

返回响应

🟢200成功

application/json

Body

pageIndex

integer

页码

可选

pageSize

integer

每页数

可选

totalPage

integer

总页数

可选

totalCount

integer

总条数

可选

hasNext

boolean

是否还有数据

可选

true：有数据；false：没有数据

data

array [object {18}]

用户列表

必需

userId

string

全局用户ID

可选

全局唯一，不同租户同手机号的用户userId是相同的

openId

string

租户用户ID

可选

租户下唯一

userName

string

用户账号

可选

全局唯一，大小写敏感忽略

name

string

用户姓名

可选

phone

string

手机号

可选

全局唯一

email

string

邮箱

可选

gender

integer

性别

可选

1：男 2：女

status

integer

状态

可选

1：正常 2：锁定 3：注销（离职）

userType

integer

用户类型

可选

用户类型。物业员工：(userType & 1) == 1，企业员工：(userType & 2) == 2 && (userType & 4) != 4，游客：(userType & 2) == 2 && (userType & 4) == 4

isAdmin

boolean

是否管理员

可选

true：是 false：否

updateTime

integer

更新时间

可选

毫秒级时间戳

headPicture

string

头像链接

可选

相对路径，访问资源需拼接https://域名/oss/路径

facePicture

string

人脸照片

可选

相对路径，访问资源需拼接https://域名/oss/路径

description

string

备注

可选

orgs

array [object {4}]

所属组织集合

可选

params

object

用户参数

可选

物业员工参数工号key：employeeNo(map data)。常用字段约定：入职日期：entryDate，格式yyyy-MM-dd；生日：birthday，格式yyyy-MM-dd。备注：用户参数使用前请先联系管理员配置。

customerInfo

object

企业员工附加信息

可选

企业员工信息

roles

array [object {2}]

用户绑定角色信息

可选

示例

{
  "pageIndex": 1,
  "pageSize": 4000,
  "totalPage": 1,
  "totalCount": 1,
  "hasNext": false,
  "data": [
    {
      "userId": "391763312369743",
      "openId": "391763312369742",
      "userName": "15423652660",
      "name": "用户210",
      "phone": "15423652660",
      "email": "15265412541@qq.com",
      "gender": 2,
      "status": 1,
      "userType": 1,
      "isAdmin": false,
      "updateTime": 1685411211283,
      "headPicture": null,
      "facePicture": "",
      "description": null,
      "orgs": [
        {
          "id": "393181889962053",
          "code": "org20230307024044184",
          "name": "新增组织",
          "orgType": 1
        },
        {
          "id": "371344636432453",
          "code": "org20230517063613156",
          "name": "AIoT项目",
          "orgType": 1
        }
      ],
      "roles": [
        {
          "id": "1763490382523322369",
          "name": "dev"
        },
        {
          "id": "1766996768541954049",
          "name": "wyj"
        }
      ],
      "params": {
        "employeeNo": "10010",
        "entryDate": "2025-01-01",
        "birthday": "2000-01-01"
      },
      "customerInfo": {
        "jobNum": "10010"
      }
    }
  ]
}

🟠400400响应结构

获取用户通行证列表(包含用户参数 工号)

请求参数

示例代码

返回响应

获取用户通行证列表(包含用户参数工号)