分页查询企业员工数据

开发中

GET

http://prod-cn.your-api-server.com/api/open/customer/customer-manage/v1/customer/list

最后修改时间：2025-04-01 07:28:48

责任人：未设置

请求参数

Query 参数

pageIndex

integer

可选

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

示例值:

pageSize

integer

可选

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

示例值:

updateTime

integer

可选

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

示例值:

1684809452768

project

string

可选

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

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://prod-cn.your-api-server.com/api/open/customer/customer-manage/v1/customer/list?pageIndex=1&pageSize=10&updateTime=1684809452768&project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU'

返回响应

🟢200成功

application/json

Body

pageIndex

integer

页码

必需

pageSize

integer

每页数

必需

totalPage

integer

总页数

必需

totalCount

integer

总条数

必需

hasNext

boolean

是否还有数据

必需

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

data

array [object {16}]

企业员工列表

必需

integer

主键ID

必需

openId

string

租户用户ID

必需

租户下唯一

userId

string

全局用户ID

必需

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

name

string

用户姓名

必需

phone

string

手机号

可选

全局唯一

username

string

用户账号

必需

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

customerStatus

integer

客户状态

可选

1正常 2禁用

sex

integer

性别

可选

性别，0：代表未填，1：男，2：女

age

integer

年龄

可选

string

邮箱

可选

remark

string

备注

可选

bornDate

integer

出生日期

可选

jobNum

string

工号

可选

facePhoto

string

人脸照片

可选

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

companies

array [object {2}]

企业信息

可选

lastModificationTime

integer

更新时间

可选

毫秒级时间戳

示例

{
  "pageIndex": 1,
  "pageSize": 1,
  "totalPage": 30,
  "totalCount": 30,
  "hasNext": true,
  "data": [
    {
      "id": 1251100287188803600,
      "openId": "1801420760462061570",
      "userId": "1801420760462061571",
      "name": "11",
      "phone": "11",
      "username": "c_1718327152699",
      "customerStatus": 1,
      "sex": 0,
      "age": 0,
      "email": "",
      "remark": "",
      "bornDate": 0,
      "jobNum": "",
      "facePhoto": "",
      "companies": [
        {
          "outId": "111",
          "id": 1279021029038379000
        },
        {
          "outId": "222",
          "id": 1279021005256675300
        }
      ],
      "lastModificationTime": 1743475238072
    }
  ]
}

🟠400400响应结构

修改于 2025-04-01 07:28:48

分页查询客户信息

分页查询企业下员工数据