分页查询用户

更新时间：2023-06-20 15:20:05下载pdf

本文介绍分页查询用户的 API。

接口描述

支持根据用户 ID 列表、商户 Code 等分页查询出用户列表信息。

接口地址

GET: /v1.1/iot-02/users

请求参数

参数名	类型	参数位置	是否必填	说明
query_user_request	QueryUserRequest	query	false	查询条件
last_row_key	String	query	false	最后一条数据的 ID
page_size	Integer	query	false	每页大小

query_user_request 说明

参数名	类型	是否必填	说明
user_nick_name	String	false	用户昵称
user_ids	String	false	用户 ID 列表
user_names	String	false	账号名称列表

返回参数

参数名	类型	说明
result	QueryMerUsersResponse

result 说明

参数名	类型	说明
list	List	用户列表
last_row_key	String	最后一条数据的 ID
page_size	Integer	每页大小
has_next	Boolean	是否有下一页

list 说明

参数名	类型	说明
user_name	String	用户名称
country_code	String	国家码
user_id	String	涂鸦用户id
user_nick_name	String	用户昵称
account_type	Integer	账号类型
create_time	Long	创建时间
tenant_code	String	租户code

请求示例

GET: /v1.1/iot-02/users?merchantCode=****12323&last_row_key=xxid&page_size=20

返回示例

{
    "result": {
        "last_row_key": "1480****472",
        "list": [
            {
                "create_time": 1641796814496,
                "user_name": "userFgMU",
                "user_nick_name": "abc",
                "country_code": "86",
                "user_id": "bay1****O7eE",
                "tenant_code": "aym0****1426"
            }
        ],
        "has_next": false,
        "page_size": 10
    },
    "t": 1641796817818,
    "success": true
}

错误码

参考错误码。

上一篇修改用户基本信息

下一篇根据用户名查询用户