中科图灵开放平台 / 智慧消防系统管理模块 / 组织成员-添加 查询接口(这是一个临时供前端保存数据的接口)

组织成员-添加 查询接口(这是一个临时供前端保存数据的接口)

接口描述: 组织成员-添加 查询接口(这是一个临时供前端保存数据的接口)

HTTP/HTTPS
请求协议
GET
请求方式
UTF-8
编码格式
JSON
返回格式
v1.0
版本号

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口
userIds字符串必须-全部的选中的人员id 示例99,36
deptId字符串必须-单位id 示例
emergencyActionNo字符串必须-临时单号(前端自定义 建议 UUID规则) 示例
type字符串必须-状态 1 已选中 2 未选中 其他代表查询全部 示例
userName字符串必须-用户名 模糊查询 示例
pageNum字符串必须-示例
pageSize字符串必须-示例
apiRequestRaw字符串可选-
headerInfo字符串可选-[]

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
data.code字符串成功
data.msg字符串
data.dataArray
data.data>>total字符串
data.data>>list数组
data.data>>list>>userId字符串
data.data>>list>>username字符串
data.data>>list>>realName字符串
data.data>>list>>phone字符串
data.data>>list>>roleId字符串
data.data>>list>>roleName字符串角色名称
data.data>>list>>deptId字符串
data.data>>list>>deptName字符串
data.data>>list>>departmentId字符串
data.data>>list>>departmentName字符串
data.data>>list>>flagType字符串0-组长,1-副组长,2-成员 其他-无状态
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 可选
userIds 必须
deptId 必须
emergencyActionNo 必须
type 必须
userName 必须
pageNum 必须
pageSize 必须
apiRequestRaw 可选
headerInfo 可选

客户端请求示例

成功响应返回示例:
{
    "code": 0,
    "msg": null,
    "data": {
        "total": 21,
        "list": [
            {
                "userId": 898,
                "username": "2",
                "realName": "2",
                "phone": "13201010101",
                "roleId": 2141,
                "roleName": "微型消防站工作人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 890,
                "username": "测试添加非最末级部门",
                "realName": "leegao",
                "phone": "13881388111",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124,126]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 889,
                "username": "xq2",
                "realName": "xqq2",
                "phone": "15927041326",
                "roleId": 3145,
                "roleName": "测试角色",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124,126]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 888,
                "username": "xq",
                "realName": "xqq",
                "phone": "15927041326",
                "roleId": 3145,
                "roleName": "测试角色",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 887,
                "username": "85",
                "realName": "96",
                "phone": "13628672210",
                "roleId": 2141,
                "roleName": "微型消防站工作人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 885,
                "username": "789654231",
                "realName": "张",
                "phone": "13628672210",
                "roleId": 2141,
                "roleName": "微型消防站工作人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 874,
                "username": "xjzz",
                "realName": "巡检组长",
                "phone": "13194448711",
                "roleId": 2143,
                "roleName": "巡查人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 854,
                "username": "12345678",
                "realName": "12345678",
                "phone": "13525241414",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 853,
                "username": "1234567",
                "realName": "1234567",
                "phone": "13524141414",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 852,
                "username": "zmy123456",
                "realName": "张明阳",
                "phone": "13628672210",
                "roleId": 2146,
                "roleName": "工程部管理人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 844,
                "username": "xffzr2",
                "realName": "测试q",
                "phone": "13687954565",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 834,
                "username": "xffzr1",
                "realName": "测试",
                "phone": "13587620020",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 826,
                "username": "zmy999",
                "realName": "张明阳",
                "phone": "13628672210",
                "roleId": 2142,
                "roleName": "消控员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 825,
                "username": "8888888888888",
                "realName": "33333333333333333",
                "phone": "13628672210",
                "roleId": 2142,
                "roleName": "消控员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 824,
                "username": "12345611111",
                "realName": "张",
                "phone": "13628672210",
                "roleId": 2147,
                "roleName": "消防管理人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 822,
                "username": "zhangmingyang",
                "realName": "张阳",
                "phone": "13628672210",
                "roleId": 2143,
                "roleName": "巡查人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 694,
                "username": "csztmr",
                "realName": "cxz",
                "phone": "15827076056",
                "roleId": 2147,
                "roleName": "消防管理人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 486,
                "username": "维保人员",
                "realName": "tts",
                "phone": "13813813811",
                "roleId": 2145,
                "roleName": "维保人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 481,
                "username": "lsk",
                "realName": "测试的勺子",
                "phone": "17671645922",
                "roleId": 2144,
                "roleName": "消防负责人",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            },
            {
                "userId": 474,
                "username": "xcry",
                "realName": "巡查人员",
                "phone": "15207161371",
                "roleId": 2143,
                "roleName": "巡查人员",
                "deptId": 460,
                "deptName": "一般单位",
                "departmentId": "[124]",
                "departmentName": null,
                "flagType": null
            }
        ],
        "pageNum": 1,
        "pageSize": 20,
        "size": 20,
        "startRow": 1,
        "endRow": 20,
        "pages": 2,
        "prePage": 0,
        "nextPage": 2,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [
            1,
            2
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 2
    }
}
失败响应返回示例:

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
409ret=409,接口流量不足
500表示服务端内部错误

本文档生成时间:2024-05-15 00:03:21