HTTP/HTTPS
请求协议
中科图灵开放平台 / 智慧消防设备管理模块 / 人员-分页
人员-分页
接口地址:https://api.iot.ink/api/app.php?s=Equipment.Admin_User_Postpage.Api
接口描述: 人员-分页
接口参数
参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
---|---|---|---|---|---|
access_token | 字符串 | 可选 | 访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口 | ||
pageNum | 字符串 | 必须 | - | 示例 | |
pageSize | 字符串 | 必须 | - | 示例 | |
deptId | 字符串 | 必须 | - | 单位id 示例 | |
isDept | 字符串 | 必须 | - | 选择了区域填1 选择单位 填0 示例 | |
username | 字符串 | 必须 | - | 用户名 示例 | |
roleId | 字符串 | 必须 | - | 角色id 示例 | |
apiRequestRaw | 字符串 | 可选 | - | ||
headerInfo | 字符串 | 可选 | - | [] |
返回字段
返回结果 | 类型 | 说明 |
---|---|---|
ret | 整型 | 状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误 |
data | 对象或混合类型 | 业务数据,由各自接口指定,通常为对象 |
data.code | 字符串 | |
data.msg | 字符串 | |
data.data | Array | |
data.data>>total | 字符串 | |
data.data>>list | 数组 | |
data.data>>list>>userId | 字符串 | 用户id |
data.data>>list>>username | 字符串 | 用户名 |
data.data>>list>>realName | 字符串 | 真实姓名 |
data.data>>list>>phone | 字符串 | 手机号 |
data.data>>list>>roleId | 字符串 | 用户关联的角色id |
data.data>>list>>roleName | 字符串 | 角色名 |
data.data>>list>>deptId | 字符串 | 用户关联的单位id |
data.data>>list>>deptName | 字符串 | 所属单位 |
data.data>>list>>departmentId | 字符串 | 所属部门id 数组 |
data.data>>list>>departmentName | 字符串 | 所属部门名称 |
data.data>>list>>departmentIdTure | 字符串 | 真实的部门id |
data.data>>list>>deptAddress | 字符串 | 单位所在地址 |
data.data>>list>>isUse | 字符串 | 是否启用 0:未启用 1:已启用 |
data.data>>list>>lastLoginTime | 字符串 | 最后登录时间 |
data.data>>list>>numberId | 字符串 | 身份证id |
data.data>>list>>email | 字符串 | 邮箱 |
data.data>>list>>certificate | 字符串 | 证书资质 |
data.data>>list>>imageList | 字符串 | 证书图片列表 |
data.data>>pageNum | 字符串 | |
data.data>>pageSize | 字符串 | |
data.data>>size | 字符串 | |
data.data>>startRow | 字符串 | |
data.data>>endRow | 字符串 | |
data.data>>pages | 字符串 | |
data.data>>prePage | 字符串 | |
data.data>>nextPage | 字符串 | |
data.data>>isFirstPage | 字符串 | |
data.data>>isLastPage | 字符串 | |
data.data>>hasPreviousPage | 字符串 | |
data.data>>hasNextPage | 字符串 | |
data.data>>navigatePages | 字符串 | |
data.data>>navigatepageNums | 数组 | |
data.data>>navigateFirstPage | 字符串 | |
data.data>>navigateLastPage | 字符串 | |
msg | 字符串 | 提示信息,失败时的错误提示 |
在线测试
参数 | 是否必须 | 值 |
---|---|---|
service | 必须 | |
access_token | 可选 | |
pageNum | 必须 | |
pageSize | 必须 | |
deptId | 必须 | |
isDept | 必须 | |
username | 必须 | |
roleId | 必须 | |
apiRequestRaw | 可选 | |
headerInfo | 可选 |
客户端请求示例
成功响应返回示例:
{"code":0,"msg":null,"data":{"total":288,"list":[{"userId":1371,"username":"testyy","realName":"科安22","phone":"18671048690","roleId":6822,"roleName":"消防负责人","deptId":1247,"deptName":"科安测试","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":null,"numberId":null,"email":null,"certificate":null,"imageList":null},{"userId":1370,"username":"yanshi","realName":"kean","phone":"18671045591","roleId":6822,"roleName":"消防负责人","deptId":1247,"deptName":"科安测试","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":null,"numberId":null,"email":null,"certificate":null,"imageList":null},{"userId":1369,"username":"user13","realName":"用户13","phone":"15280000013","roleId":6718,"roleName":"运营单位管理员","deptId":1236,"deptName":"照明单位13","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-10 14:49:22","numberId":null,"email":"631774218@qq.com","certificate":null,"imageList":null},{"userId":1368,"username":"user12","realName":"用户12","phone":"15280000012","roleId":6717,"roleName":"运营单位管理员","deptId":1235,"deptName":"照明单位12","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-14 12:24:35","numberId":null,"email":"1174987051@qq.com","certificate":null,"imageList":null},{"userId":1367,"username":"user11","realName":"用户11","phone":"15280000011","roleId":6696,"roleName":"运营单位管理员","deptId":1232,"deptName":"照明单位11","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-14 17:01:11","numberId":null,"email":null,"certificate":null,"imageList":null},{"userId":1366,"username":"user10","realName":"用户表10","phone":"15280000010","roleId":6595,"roleName":"运营单位管理员","deptId":1221,"deptName":"照明单位10","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-14 11:07:05","numberId":null,"email":null,"certificate":null,"imageList":null},{"userId":1365,"username":"xuan","realName":"xuan","phone":"18727952680","roleId":6584,"roleName":"运营单位管理员","deptId":1219,"deptName":"照明业务单位","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-09 15:00:56","numberId":null,"email":null,"certificate":null,"imageList":null},{"userId":1364,"username":"yangqi224222","realName":"杨启","phone":"18671048594","roleId":2170,"roleName":"维保人员","deptId":464,"deptName":"测试124","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":null,"numberId":"420624199510163639","email":"310160433@qq.com","certificate":null,"imageList":null},{"userId":1363,"username":"yangqi22422","realName":"杨启","phone":"18671048599","roleId":2170,"roleName":"维保人员","deptId":464,"deptName":"测试124","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":null,"numberId":"420624199510163639","email":"310160433@qq.com","certificate":null,"imageList":null},{"userId":1361,"username":"user91","realName":"用户91","phone":"15280000091","roleId":6509,"roleName":"运营单位管理员","deptId":1207,"deptName":"照明单位9","departmentId":"[]","departmentName":null,"departmentIdTure":null,"deptAddress":null,"isUse":1,"lastLoginTime":"2022-06-08 19:23:12","numberId":null,"email":null,"certificate":null,"imageList":null}],"pageNum":1,"pageSize":10,"size":10,"startRow":1,"endRow":10,"pages":29,"prePage":0,"nextPage":2,"isFirstPage":true,"isLastPage":false,"hasPreviousPage":false,"hasNextPage":true,"navigatePages":8,"navigatepageNums":[1,2,3,4,5,6,7,8],"navigateFirstPage":1,"navigateLastPage":8}}
失败响应返回示例:
错误列表
错误状态码 | 错误描述信息 |
---|---|
400 | ret=400,客户端参数错误或非法请求 |
404 | 表示接口服务不存在 |
406 | ret=406,access_token令牌校验不通过 |
407 | ret=407,app_key权限不足,或未知应用 |
408 | ret=408,当前用户禁止使用,或用户未登录 |
409 | ret=409,接口流量不足 |
500 | 表示服务端内部错误 |
本文档生成时间:2024-04-27 22:29:39