Get Users (사용자 목록 조회)

사용자 목록을 페이지네이션 방식으로 조회합니다. 필터링 및 정렬 기능을 지원합니다.

엔드포인트

GET /api/v1/users

요청 파라미터

필드	타입	필수	설명
search	string	✖	name 또는 email 검색
page	number	✖	페이지 번호 (기본값: 1)
limit	number	✖	페이지당 결과 수 (기본값: 20)
sort	string	✖	정렬 기준 (name, email, createdAt) (기본값: createdAt)
sortOrder	string	✖	정렬 방향 (asc, desc) (기본값: asc)

요청 예시

GET /api/v1/users?sortOrder=desc&sort=createdAt&page=1&limit=20 HTTP/1.1
Host: api.lab.sense.im
Authorization: Bearer your-client-key

응답

{
  "code": 200,
  "message": "요청이 성공적으로 완료되었습니다.",
  "users": [
    {
      "userId": "5",
      "name": "히히히",
      "email": "[email protected]",
      "createdAt": "2025-01-20T11:58:16.885Z",
      "updatedAt": "2025-01-20T11:58:16.885Z"
    },
    {
      "userId": "3",
      "name": "덕구",
      "email": "[email protected]",
      "createdAt": "2025-01-17T08:41:21.542Z",
      "updatedAt": "2025-01-17T08:41:21.542Z"
    },
    {
      "userId": "2",
      "name": "덕구",
      "email": "[email protected]",
      "createdAt": "2025-01-17T08:38:23.479Z",
      "updatedAt": "2025-01-17T08:38:23.479Z"
    },
    {
      "userId": "1",
      "name": "덕구",
      "email": "[email protected]",
      "createdAt": "2025-01-17T08:36:47.666Z",
      "updatedAt": "2025-01-17T08:36:47.666Z"
    }
  ],
  "count": 4
}

상태 코드

코드	설명
200	요청이 성공적으로 처리됨
400	잘못된 요청 (파라미터 오류 등)
401	인증 오류
404	프로젝트를 찾을 수 없음