[GET] 유저 목록 조회

META에 등록된 에이전트 소속의 유저들을 조회합니다.

반환되는 결과는 페이지 단위로 나뉘어 전달됩니다.

---

Get users

GET /api/users/list

Query String Parameter

쿼리 스트링으로 페이지네이션, 정렬, 검색을 수행할 수 있습니다.

쿼리 스트링으로 아무것도 주어지지 않을 시, 기본으로 가장 최근에 생성된 유저 200명을 조회합니다.

Name	Type	Description
sortBy	Enum id created_at updated_at username balance	정렬 시 기준이 되는 필드 Default: created_at
sortDirection	Enum asc desc	정렬 시 오름차순, 내림차순 방향 Default: desc
page	Number string	요청할 페이지 번호 Default: 0
size	Number string	한 페이지에 포함할 유저 수 Default: 200
searchString	String	Input 문자열로 시작하는 유저를 검색 시 사용합니다.

updated_at, desc 정렬로 실시간 유저 동향을 파악할 수 있습니다.

Response

200 Success

{
    "list": [
        {
            "id": 1,
            "provider_user_id": "17496472695931912783",
            "username": "evolution-prod-01",
            "balance": "0",
            "game_url_token": null,
            "last_accessed_game_id": 1,
            "last_accessed_at": "2025-06-11T13:08:03.551Z",
            "isPlaying": true,
            "kick_until": null,
            "updated_at": "2025-06-11T13:08:03.552Z",
            "created_at": "2025-06-11T13:07:49.594Z",
            "agent_id": 1,
            "idcode": "1",
        },
        {
            "id": 2,
            "provider_user_id": "17496298401173004987",
            "username": "pgtest",
            "balance": "0",
            "game_url_token": null,
            "last_accessed_game_id": 2,
            "last_accessed_at": "2025-06-11T09:33:03.681Z",
            "isPlaying": false,
            "kick_until": null,
            "updated_at": "2025-06-11T10:03:08.528Z",
            "created_at": "2025-06-11T08:17:20.118Z",
            "agent_id": 1,
            "idcode": "1",
        }
    },
    "total": 77,
    "totalPages": 8
}

404 Not found