API 목록

API 목록으로 돌아가기

세미나 생성

요청

Request

POST /seminars?openDate=2024-03-22 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2NjMiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.W2K-04FjAT2wbU_bQMBDbkEhrNdnLmcsiR-Zy7QaRf0

Request Cookies

Name Description

accessToken

ACCESS TOKEN (ROLE_회장, ROLE_부회장, ROLE_서기)

Query Parameters

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

openDate

true

yyyy-MM-dd

세미나 날짜

응답

Response

HTTP/1.1 201 Created
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: 15

{
  "id" : 36
}

Response Fields

Path Type Description

id

Number

세미나 ID

세미나 시작

요청

Request

POST /seminars/33 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 98
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2NTEiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.vNyfzBC9kG1o75iqhH-4zKYv4p0ZcURQyrHFQCMy0TM

{
  "attendanceCloseTime" : "2024-03-22 14:55:29",
  "latenessCloseTime" : "2024-03-22 14:56:29"
}

Request Cookies

Name Description

accessToken

ACCESS TOKEN (ROLE_회장, ROLE_부회장, ROLE_서기)

Path Parameters

Table 1. /seminars/{seminarId}
Parameter Description

seminarId

세미나의 ID

Request Fields

필드명 타입 필수값 양식 설명

attendanceCloseTime

String

true

yyyy-MM-dd HH:mm:ss

출석 마감 시간

latenessCloseTime

String

true

yyyy-MM-dd HH:mm:ss

지각 마감 시간

응답

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: 31

{
  "attendanceCode" : "2128"
}

Response Fields

Path Type Description

attendanceCode

String

세미나 출석 코드

이번 학기 세미나 전부 조회

요청

Request

GET /seminars HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2MDYiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.cMYOyCJM3PWsl283Ft2Q77-EhEmX0DJAQ3SIHnBeZZQ

Request Cookies

Name Description

accessToken

ACCESS TOKEN (ROLE_회장, ROLE_부회장, 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: 867

{
  "seminarList" : [ {
    "id" : 22,
    "openTime" : "2024-03-22T00:00:00",
    "attendanceCloseTime" : null,
    "latenessCloseTime" : null,
    "attendanceCode" : null,
    "name" : "2024-03-22",
    "registerTime" : "2024-03-22T14:52:29",
    "updateTime" : "2024-03-22T14:52:29"
  }, {
    "id" : 23,
    "openTime" : "2024-03-20T00:00:00",
    "attendanceCloseTime" : null,
    "latenessCloseTime" : null,
    "attendanceCode" : null,
    "name" : "2024-03-20",
    "registerTime" : "2024-03-22T14:52:29",
    "updateTime" : "2024-03-22T14:52:29"
  }, {
    "id" : 21,
    "openTime" : "2024-03-17T00:00:00",
    "attendanceCloseTime" : "2024-03-22T14:55:29",
    "latenessCloseTime" : "2024-03-22T14:56:29",
    "attendanceCode" : "5455",
    "name" : "2024-03-17",
    "registerTime" : "2024-03-22T14:52:29",
    "updateTime" : "2024-03-22T14:52:29"
  } ]
}

Response Fields

Path Type Description

seminarList[].id

Number

세미나 ID

seminarList[].openTime

String

세미나 생성 시간

seminarList[].attendanceCloseTime

String

출석 마감 시간

seminarList[].latenessCloseTime

String

지각 마감 시간

seminarList[].attendanceCode

String

출석 코드

seminarList[].name

String

세미나명

seminarList[].registerTime

String

DB 생성 시간

seminarList[].updateTime

String

DB 업데이트 시간

세미나 조회

요청

Request

GET /seminars/29 HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2MzkiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.rD-0Zh985ySQjLW0hZDvSaIow8gzIlHUPFlSrmKmcSw

Path Parameters

Table 2. /seminars/{seminarId}
Parameter Description

seminarId

검색할 세미나 ID를 입력해주세요.

Request Cookies

Name Description

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: 304

{
  "id" : 29,
  "name" : "2024-03-22",
  "openTime" : "2024-03-22T00:00:00",
  "attendanceStartTime" : "2024-03-22T14:52:30",
  "attendanceCloseTime" : "2024-03-22T14:55:29",
  "latenessCloseTime" : "2024-03-22T14:56:29",
  "statusType" : "ATTENDANCE",
  "attendanceCode" : "2423",
  "starterId" : 639
}

Response Fields

Path Type Description

id

Number

세미나 ID

openTime

String

세미나 생성 시간

attendanceStartTime

String

출석 시작 시간

attendanceCloseTime

String

출석 마감 시간

latenessCloseTime

String

지각 마감 시간

name

String

세미나명

statusType

String

세미나 출석 상태

attendanceCode

String

세미나 출석 코드

starterId

Number

세미나 출석을 시작한 회원 ID

이용 가능한 세미나 조회

요청

Request

GET /seminars/available HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2MzMiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.V3OVCndeZU3__zAm5t3LRTwOcLzROLrhNoXkNSMVVOA

Request Cookies

Name Description

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: 285

{
  "id" : 28,
  "openTime" : "2024-03-22T00:00:00",
  "attendanceCloseTime" : "2024-03-22T14:55:29",
  "latenessCloseTime" : "2024-03-22T14:56:29",
  "attendanceCode" : "9286",
  "name" : "2024-03-22",
  "registerTime" : "2024-03-22T14:52:29",
  "updateTime" : "2024-03-22T14:52:29"
}

Response Fields

Path Type Description

id

Number

세미나 ID

openTime

String

세미나 생성 시간

attendanceCloseTime

String

출석 마감 시간

latenessCloseTime

String

지각 마감 시간

attendanceCode

String

출석 코드

name

String

세미나명

registerTime

String

DB 생성 시간

updateTime

String

DB 업데이트 시간

세미나 날짜로 조회

요청

Request

GET /seminars?date=2024-03-22 HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI2MjEiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ5LCJleHAiOjE3MTExMjI3NDl9.zqiMMQEtn7togzHZE7FQQvXO5Vrg3U7JQGq02cF98KQ

Query Parameters

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

date

true

yyyy-MM-dd

검색할 날짜를 입력해주세요.

Request Cookies

Name Description

accessToken

ACCESS TOKEN (ROLE_회장, 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: 285

{
  "id" : 25,
  "openTime" : "2024-03-22T00:00:00",
  "attendanceCloseTime" : "2024-03-22T14:55:29",
  "latenessCloseTime" : "2024-03-22T14:56:29",
  "attendanceCode" : "2274",
  "name" : "2024-03-22",
  "registerTime" : "2024-03-22T14:52:29",
  "updateTime" : "2024-03-22T14:52:29"
}

Response Fields

Path Type Description

id

Number

세미나 ID

openTime

String

세미나 생성 시간

attendanceCloseTime

String

출석 마감 시간

latenessCloseTime

String

지각 마감 시간

attendanceCode

String

출석 코드

name

String

세미나명

registerTime

String

DB 생성 시간

updateTime

String

DB 업데이트 시간

세미나 삭제

요청

Request

DELETE /seminars/20 HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI1OTciLCJyb2xlcyI6IlJPTEVf7ZqM7JuQLFJPTEVf7ZqM7J6lIiwiaWF0IjoxNzExMTE5MTQ4LCJleHAiOjE3MTExMjI3NDh9.WZjtE6GhQOltUNEw4AVVTY-pzHqWGJPjlZXEJegRmis

Path Parameters

Table 3. /seminars/{seminarId}
Parameter Description

seminarId

삭제할 세미나 ID를 입력해주세요.

Request Cookies

Name Description

accessToken

ACCESS TOKEN (ROLE_회장, ROLE_부회장, ROLE_서기)

응답

Response

HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
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

지난 세미나 중 가장 최근의 세미나 조회

어제까지의 세미나 중, 가장 현재와 가까운 세미나 1개를 조회합니다.

요청

Request

GET /seminars/recently-done HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI1OTYiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTQ4LCJleHAiOjE3MTExMjI3NDh9.TIWkJrbAPQI_xVRJit0G_gBeTTemNnk3PdYTskVRRIs

Request Cookies

Name Description

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: 15

{
  "id" : 19
}

Response Fields

Path Type Description

id

Number

세미나 ID

가장 최근의 예정된 세미나 2개 조회

오늘을 포함하여 가장 최근의 예정된 세미나 2개를 조회합니다.

요청

Request

GET /seminars/recently-upcoming HTTP/1.1
Host: docs.api.com
Cookie: accessToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI1OTMiLCJyb2xlcyI6IlJPTEVf7ZqM7JuQIiwiaWF0IjoxNzExMTE5MTQ4LCJleHAiOjE3MTExMjI3NDh9.L6FOVbysMegA6x6-Z26J8favdOjIP4GuWCr_PioX-8w

Request Cookies

Name Description

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: 36

[ {
  "id" : 17
}, {
  "id" : 18
} ]

Response Fields

Path Type Description

[].id

Number

세미나 ID