API Documentation - LikeLion-KNU/dongBTI GitHub Wiki

전체 μ‚¬μš©μž 쑰회

동BTI 검사λ₯Ό μ§„ν–‰ν•œ 전체 μ‚¬μš©μž 수λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€

➑️ Request

METHOD GET
PATH /stats/total

⬅️ Response

200 성곡

{
   "status" : 200,
   "total_count" : 0
}

전체 μ‚¬μš©μž λŒ€λΉ„ ν•΄λ‹Ή MBTI μ‚¬μš©μž 수 쑰회

동BTI 검사λ₯Ό μ§„ν–‰ν•œ 전체 μ‚¬μš©μž 수 λŒ€λΉ„ ν•΄λ‹Ή MBTI κ²°κ³Όκ°€ λ‚˜μ˜¨ 인원 수λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€

➑️ Request

METHOD GET
PATH /stats?type=TYPE

⬅️ Response

200 성곡

{
   "status" : 200,
   "count" : 0,
   "total_count" : 0
}

400 BAD REQUEST (μœ νš¨ν•˜μ§€ μ•Šμ€ Type)

{
   "status" : 400,
   "message" : "type 의 값이 μœ νš¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€"
}

κ²°κ³Ό 생성

동BTI 검사λ₯Ό μ§„ν–‰ν•œ κ²°κ³Όλ₯Ό μ €μž₯ν•©λ‹ˆλ‹€

➑️ Request

METHOD POST
PATH /stats

BODY

{
   "department" : "enum",
   "mbti" : "string"
}

❗️department ν•„λ“œμ— λ“€μ–΄κ°ˆ 수 μžˆλŠ” κ°’
"humanities", "social-sciences", "natural-sciences", "economics", "engineering", "it", "agriculture", "arts", "teachers", "medicine", "dentisty", "vet", "human-sciences", "nursing", "pharmacy", "advanced-technology", "environment", "science-technology", "administration", "undeclared"

⬅️ Response

201 성곡

{
   "status" : 201,
   "data" : {
       "id" : "string",
       "total_count" : 0
   }
}

400 BAD REQUEST (μœ νš¨ν•˜μ§€ μ•Šμ€ Department)

{
   "status" : 400,
   "message" : "department 의 값이 μœ νš¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€"
}

400 BAD REQUEST (μœ νš¨ν•˜μ§€ μ•Šμ€ mbti)

{
   "status" : 400,
   "message": "mbti λŠ” string 값이어야 ν•©λ‹ˆλ‹€"
}

전체 μƒμœ„ 10개 MBTI μœ ν˜• 쑰회

전체 μ‚¬μš©μž 쀑 MBTI μœ ν˜• μƒμœ„ 10개λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€

➑️ Request

METHOD GET
PATH /stats/top/mbti

⬅️ Response

200 성곡

{
   "status" : 200,
   "top" : [
       ["MBTI TYPE", 10],
       ["MBTI TYPE", 8],
       ["MBTI TYPE", 3],
   ]
}

학과별 μƒμœ„ 10개 MBTI μœ ν˜• 쑰회

학과별 MBTI μœ ν˜• μƒμœ„ 10개λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€

➑️ Request

METHOD GET
PATH /stats/top/department
QUERY key=DEPARTMENT_TYPE
ex) /stats/top/department?key=it

⬅️ Response

200 성곡

{
   "status" : 200,
   "top" : [
       ["MBTI TYPE", 10],
       ["MBTI TYPE", 8],
       ["MBTI TYPE", 3],
   ]
}

400 BAD REQUEST (μœ νš¨ν•˜μ§€ μ•Šμ€ Department Query Key)

{
   "status" : 400,
   "message" : "department 의 값이 μœ νš¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€"
}
⚠️ **GitHub.com Fallback** ⚠️