ATTENDANCE API 문서

당일의 출석 시간이 빠른 순서대로 정렬되어 조회됩니다.

요청

Request

GET /attendances/today-rank?page=0&size=3 HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI5Iiwicm9sZXMiOiJST0xFX-2ajOybkCIsImlhdCI6MTcxMTExOTEyMSwiZXhwIjoxNzExMTIyNzIxfQ._qYjggKHzVinZ7CcdLAy11fG_xdICk_1f4yS0YKYlVY

Request Cookies

Name Description

Name	Description
`accessToken`	ACCESS TOKEN (ROLE_회원)

accessToken

ACCESS TOKEN (ROLE_회원)

Query Parameters

파라미터명 필수값 양식 설명

파라미터명	필수값	양식	설명
`page`			페이지 (default: 0)
`size`			한 페이지당 불러올 개수 (default: 10)

page

페이지 (default: 0)

size

한 페이지당 불러올 개수 (default: 10)

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 984

{
  "content" : [ {
    "rank" : 1,
    "thumbnailPath" : null,
    "realName" : "XpLSJffVfd",
    "generation" : "15.0",
    "totalAttendance" : 0,
    "time" : "2024-03-22 14:52:01"
  }, {
    "rank" : 1,
    "thumbnailPath" : null,
    "realName" : "FJSPnCbxbS",
    "generation" : "15.0",
    "totalAttendance" : 0,
    "time" : "2024-03-22 14:52:01"
  }, {
    "rank" : 1,
    "thumbnailPath" : null,
    "realName" : "PyjnVIHpeF",
    "generation" : "15.0",
    "totalAttendance" : 0,
    "time" : "2024-03-22 14:52:01"
  } ],
  "pageable" : {
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "offset" : 0,
    "pageNumber" : 0,
    "pageSize" : 3,
    "paged" : true,
    "unpaged" : false
  },
  "last" : true,
  "totalPages" : 1,
  "totalElements" : 3,
  "first" : true,
  "size" : 3,
  "number" : 0,
  "sort" : {
    "empty" : true,
    "sorted" : false,
    "unsorted" : true
  },
  "numberOfElements" : 3,
  "empty" : false
}

Response Fields

Path Type Description

Path	Type	Description
`content[].rank`	`Number`	회원 당일 출석 순위
`content[].thumbnailPath`	`Null`	회원 썸네일 경로
`content[].realName`	`String`	회원 실명
`content[].generation`	`String`	회원 기수
`content[].totalAttendance`	`Number`	회원 연속 출석 일수
`content[].time`	`String`	회원 출석 시간
`empty`	`Boolean`	가져오는 페이지가 비어 있는 지
`first`	`Boolean`	첫 페이지인지
`last`	`Boolean`	마지막 페이지인지
`number`	`Number`	페이지 number (0부터 시작)
`numberOfElements`	`Number`	현재 페이지의 데이터 개수
`pageable`	`Object`	페이지에 대한 부가 정보
`sort.empty`	`Boolean`	정렬 기준이 비어 있는 지
`sort.sorted`	`Boolean`	정렬이 되었는지
`sort.unsorted`	`Boolean`	정렬이 되지 않았는지
`totalPages`	`Number`	총 페이지 수
`totalElements`	`Number`	총 요소 수
`size`	`Number`	한 페이지당 데이터 개수

content[].rank

Number

회원 당일 출석 순위

content[].thumbnailPath

Null

회원 썸네일 경로

content[].realName

String

회원 실명

content[].generation

String

회원 기수

content[].totalAttendance

Number

회원 연속 출석 일수

content[].time

String

회원 출석 시간

empty

Boolean

가져오는 페이지가 비어 있는 지

first

Boolean

첫 페이지인지

last

Boolean

마지막 페이지인지

number

Number

페이지 number (0부터 시작)

numberOfElements

Number

현재 페이지의 데이터 개수

pageable

Object

페이지에 대한 부가 정보

sort.empty

Boolean

정렬 기준이 비어 있는 지

sort.sorted

Boolean

정렬이 되었는지

sort.unsorted

Boolean

정렬이 되지 않았는지

totalPages

Number

총 페이지 수

totalElements

Number

총 요소 수

size

Number

한 페이지당 데이터 개수

연속 출석 랭킹 조회

연속 출석일이 많은 순으로 정렬되어 조회됩니다.

요청

Request

GET /attendances/continuous-rank HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI1Iiwicm9sZXMiOiJST0xFX-2ajOybkCIsImlhdCI6MTcxMTExOTEyMCwiZXhwIjoxNzExMTIyNzIwfQ.5wmIU0yrbqJj61GRiCQ7OzIx5VU-Zj0cdkJMju-Ys2s

Request Cookies

Name Description

Name	Description
`accessToken`	ACCESS TOKEN (ROLE_회원)

accessToken

ACCESS TOKEN (ROLE_회원)

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 467

[ {
  "rank" : 1,
  "thumbnailPath" : null,
  "realName" : "uquxpHjXVQ",
  "generation" : "15.0",
  "continuousDay" : 3,
  "time" : "2024-03-22 14:52:00"
}, {
  "rank" : 1,
  "thumbnailPath" : null,
  "realName" : "opmkugtMhp",
  "generation" : "15.0",
  "continuousDay" : 2,
  "time" : "2024-03-22 14:52:00"
}, {
  "rank" : 1,
  "thumbnailPath" : null,
  "realName" : "lnINXhkbrl",
  "generation" : "15.0",
  "continuousDay" : 1,
  "time" : "2024-03-22 14:52:00"
} ]

Response Fields

Path Type Description

Path	Type	Description
`[].rank`	`Number`	회원 당일 출석 순위
`[].thumbnailPath`	`Null`	회원 썸네일 경로
`[].realName`	`String`	회원 실명
`[].generation`	`String`	회원 기수
`[].continuousDay`	`Number`	회원 연속 출석 일수
`[].time`	`String`	회원 출석 시간

[].rank

Number

회원 당일 출석 순위

[].thumbnailPath

Null

회원 썸네일 경로

[].realName

String

회원 실명

[].generation

String

회원 기수

[].continuousDay

Number

회원 연속 출석 일수

[].time

String

회원 출석 시간

당일 출석 포인트 조회

요청

Request

GET /attendances/point HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0Iiwicm9sZXMiOiJST0xFX-2ajOybkCIsImlhdCI6MTcxMTExOTEyMCwiZXhwIjoxNzExMTIyNzIwfQ.HIRxaAj2S_kmvA1dPXR2Uubc37ddffjV1KM6qYjqGSM

Request Cookies

Name Description

Name	Description
`accessToken`	ACCESS TOKEN (ROLE_회원)

accessToken

ACCESS TOKEN (ROLE_회원)

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 90

{
  "point" : 100,
  "continuousPoint" : 800,
  "rankPoint" : 400,
  "randomPoint" : 200
}

Response Fields

Path Type Description

Path	Type	Description
`point`	`Number`	기본 포인트
`continuousPoint`	`Number`	연속 출석 포인트
`rankPoint`	`Number`	순위 포인트
`randomPoint`	`Number`	랜덤 포인트

point

Number

기본 포인트

continuousPoint

Number

연속 출석 포인트

rankPoint

Number

순위 포인트

randomPoint

Number

랜덤 포인트

출석 정보 조회

요청

Request

GET /attendances/members/3/info HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIzIiwicm9sZXMiOiJST0xFX-2ajOybkCIsImlhdCI6MTcxMTExOTExOSwiZXhwIjoxNzExMTIyNzE5fQ.gLl75qUjqzn2025eZIHSK6U7gfWmUB42yRXBLmp7QDQ

Request Cookies

Name Description

Name	Description
`accessToken`	ACCESS TOKEN (ROLE_회원)

accessToken

ACCESS TOKEN (ROLE_회원)

Path Parameters

Table 1. /attendances/members/{memberId}/info
Parameter	Description
`memberId`	회원 ID

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 92

{
  "totalAttendance" : 0,
  "continuousDay" : 0,
  "todayRank" : 1,
  "todayPoint" : 1500
}

Response Fields

Path Type Description

Path	Type	Description
`totalAttendance`	`Number`	총 출석일
`continuousDay`	`Number`	연속 출석일
`todayRank`	`Number`	출석 순위
`todayPoint`	`Number`	오늘 출석 포인트

totalAttendance

Number

총 출석일

continuousDay

Number

연속 출석일

todayRank

Number

출석 순위

todayPoint

Number

오늘 출석 포인트

출석 정보 목록 조회

요청

Request

GET /attendances/members/2/total?localDate=2023-03-22 HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIyIiwicm9sZXMiOiJST0xFX-2ajOybkCIsImlhdCI6MTcxMTExOTExOSwiZXhwIjoxNzExMTIyNzE5fQ.l7PduYZzf4hRZ0ULWmoocpDWKB27QpTd6xVCYbH72lc

Request Cookies

Name Description

Name	Description
`accessToken`	ACCESS TOKEN (ROLE_회원)

accessToken

ACCESS TOKEN (ROLE_회원)

Path Parameters

Table 2. /attendances/members/{memberId}/total
Parameter	Description
`memberId`	회원 ID

Query Parameters

보낸 날짜로부터 오늘까지의 출석 정보를 조회합니다.

파라미터명 필수값 양식 설명

파라미터명	필수값	양식	설명
`localDate`	true	yyyy-MM-dd	년도

localDate

true

yyyy-MM-dd

년도

응답

Response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 45

[ {
  "value" : 1,
  "day" : "2024-03-22"
} ]

Response Fields

Path Type Description

Path	Type	Description
`[].value`	`Number`	고정 값 1
`[].day`	`String`	출석 한 날짜

[].value

Number

고정 값 1

[].day

String

출석 한 날짜