host

1. 获取用户列表

请求路径

  • http://{host}/api/{platform}/getUserList

请求方法

  • get

headers

字段名 类型 必填 说明
access-token String true API_TOKEN

请求参数:

字段名 类型 必填 说明
pageNum String false 分页页码
pageSize String false 分页页码
name String false 搜索用户姓名

返回格式:

{
    "code": 0,
    "message": "success",
    "requestId": "6FCCF35F66444E79AEE7C47758EB0161",
    "data": {
        "total": 21,
        "pages": 21,
        "data": [
            {
                "openId": "Dx224933",  // 账号openId
                "name": "测试用户1"  // 用户名称
            }
        ],
        "isHasNextPage": true
    }
}

异常示例

2. 创建用户

请求路径

  • http://{host}/api/{platform}/third/addUser

请求方法

  • post

headers

字段名 类型 必填 说明
access-token String true API_TOKEN

请求参数:

字段名 类型 必填 说明
code String true 用户的openId， 外部系统自行维护，建议使用加密用户userid
sign String true 签名，签名算法：sign=md5(userName+code++secret)
userName String true 用户名
corpId String true 企业标识

返回格式:

{
    "code": 0,
    "message": "success",
    "requestId": "7D9B52AC917241BF9A66EF1FB7F9E977",
    "data": {
        "userName": "用户11",  // 用户名
        "userId": "addd",  // 用户openid
        "userUid": 9145750   // 用户uid, 后续对接接口需要使用
    }
}

2. 删除用户

请求路径

  • http://{host}/api/{platform}/third/deleteUser

请求方法

  • post

headers

字段名 类型 必填 说明
access-token String true API_TOKEN

请求参数:

字段名 类型 必填 说明
code String true 用户的openId， 外部系统自行维护，建议使用加密用户userid
sign String true 签名，签名算法：sign=md5(code+secret)
corpId String true 企业标识

返回格式:

{
    "code":0,
    "message":"success",
    "requestId":"267012784EAC450E9ECB6B8BA0073978"
}
文档更新时间: 2025-07-25 15:12   作者：胡进