1. 查询

2. 查询(指定用户标识或用户名查询)

3. 分页查询

用户查询


1.查询

GET

/v1/users?access_token={access_token}&query={query}&type={type}&matching={matching}

请求头

请求头 说明
Content-Type application/json

请求参数

字段 类型 是否必填 说明
access_token String Y 访问令牌
query String Y 查询条件,当matching =true,代表匹配用户名或用户标识,当matching =false,代表完全匹配用户名或模糊匹配用户姓名,拼音,简拼字段
type String Y 查询类型,当type=id查询条件query为用户标识,当type=username查询条件query为用户名
matching String Y 是否匹配query,当matching =true时,query可以多条件查询,以[,]分隔开多条件,如query=id1,id2

请求示例

[1].模糊匹配查询
/v1/users?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&query=136
[2].匹配查询用户标识
/v1/users?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&query=92353e192ef4492f8d2772fef98f29be&matching=true&type=id
[3].匹配查询用户名
/v1/users?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&query=13610117012&matching=true&type=username

返回数据

{
    "status": 0,
    "message": "Everything is ok.",
    "result":{
        "total_count": 1,
        "users":[
            {
                "user_id": "92353e192ef4492f8d2772fef98f29be",
                "domain_id": "atwork",
                "status": "ACTIVATED",
                "state": "NORMAL",
                "username": "13610117012",
                "name": "13610117012",
                "pinyin": "13610117012",
                "initial": "13610117012",
                "nickname": "13610117012",
                "phone": "13610117012",
                "email": "13610117012@qq.com",
                "gender": "MALE",
                "birthday": 1472601600000,
                "disabled": false
            }
        ]
    }
}

错误返回值

status message 说明
10011 token not found. 访问令牌不存在

2. 查询(指定用户标识或用户名查询)

GET

/v1/users/{query}?access_token={access_token}&type={type}

请求头

请求头 说明
Content-Type application/json

请求参数

字段 类型 是否必填 说明
access_token String Y 访问令牌
query String Y 查询条件,根据type判断
type String Y 查询类型,当type=id查询条件query为用户标识,当type=username查询条件query为用户名

请求示例

[1].匹配查询用户名
/v1/users/13610117012?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&type=username
[2].匹配查询用户标识
/v1/users/92353e192ef4492f8d2772fef98f29be?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&type=id

返回数据

{
    "status": 0,
    "message": "Everything is ok.",
    "result":{
        "user_id": "92353e192ef4492f8d2772fef98f29be",
        "domain_id": "atwork",
        "status": "ACTIVATED",
        "state": "NORMAL",
        "username": "13610117012",
        "name": "13610117012",
        "pinyin": "13610117012",
        "initial": "13610117012",
        "nickname": "13610117012",
        "phone": "13610117012",
        "email": "13610117012@qq.com",
        "gender": "MALE",
        "birthday": 1472601600000,
        "disabled": false
    }
}

错误返回值

status message 说明
10011 token not found. 访问令牌不存在

3. 分页查询

GET

/v1/users?access_token={access_token}&skip={skip}&limit={limit}&refresh_time={refresh_time}

请求头

请求头 说明
Content-Type application/json

请求参数

字段 类型 是否必填 说明
access_token String Y 访问令牌
skip String N 开始记录数,默认值 0
limit String N 最大记录数,默认值 10
refresh_time String N 刷新时间戳,获取刷新时间以后的记录,默认值 -1

示例

/v1/users?access_token=8e0d7b9e4e4a49b888d6b0b5f882b7cd&skip=0&limit=10&refresh_time=-1

返回数据

{
    "status": 0,
    "message": "Everything is ok.",
    "result":{
        "total_count": 1,
        "users":[
            {
                "user_id": "92353e192ef4492f8d2772fef98f29be",
                "domain_id": "atwork",
                "status": "ACTIVATED",
                "state": "NORMAL",
                "username": "13610117012",
                "name": "13610117012",
                "pinyin": "13610117012",
                "initial": "13610117012",
                "nickname": "13610117012",
                "phone": "13610117012",
                "email": "13610117012@qq.com",
                "gender": "MALE",
                "birthday": 1472601600000,
                "disabled": false
            }
        ]
    }
}

错误返回值

status message 说明
10011 token not found. 访问令牌不存在

results matching ""

    No results matching ""