활동 API

GET /api/volunteer-service/?yy=2025&smt=11

{
  "yy": "2025",
  "smt": "11",
  "period_list": [
    {
      "YY": "2025",
      "SMT": "11",
      "SMT_NM": "1학기",
      "FRMT_DT": "20250301",
      "END_DT": "20250630"
    },
    {
      "YY": "2024",
      "SMT": "21",
      "SMT_NM": "2학기",
      "FRMT_DT": "20240901",
      "END_DT": "20241231"
    }
  ],
  "aply_list": [
    {
      "ORGAN_CD": "ORG001",
      "ORGAN_NM": "아산시자원봉사센터",
      "SERV_CD": "VS202501001",
      "SERV_NM": "노인복지관 급식 봉사",
      "SERV_DT": "20250315",
      "SERV_PLACE": "아산시 온양노인복지관 3층 식당",
      "SERV_TIME": "4",
      "APLY_DT": "20250308",
      "APLY_ST": "01",
      "APLY_ST_NM": "신청완료"
    }
  ],
  "service_list": [
    {
      "ORGAN_CD": "ORG002",
      "ORGAN_NM": "순천향대학교병원",
      "SERV_CD": "VS202501010",
      "SERV_NM": "병원 환경정화 및 환자 안내 봉사",
      "SERV_DT": "20250322",
      "SERV_PLACE": "순천향대학교병원 본관 1층 로비",
      "SERV_TIME": "3",
      "MAX_CNT": "20",
      "APLY_CNT": "12",
      "REMAIN_CNT": "8",
      "APLY_STRT_DT": "20250310",
      "APLY_END_DT": "20250319"
    },
    {
      "ORGAN_CD": "ORG003",
      "ORGAN_NM": "아산시청 자원봉사팀",
      "SERV_CD": "VS202501020",
      "SERV_NM": "지역 하천 환경정화 활동",
      "SERV_DT": "20250329",
      "SERV_PLACE": "아산시 곡교천 일원",
      "SERV_TIME": "4",
      "MAX_CNT": "50",
      "APLY_CNT": "34",
      "REMAIN_CNT": "16",
      "APLY_STRT_DT": "20250315",
      "APLY_END_DT": "20250326"
    }
  ]
}

{
  "error": "UNAUTHORIZED",
  "message": "세션이 만료되었거나 유효하지 않습니다."
}

{
  "yy": "2025",
  "smt": "11",
  "organ_cd": "ORG002",
  "serv_cd": "VS202501010"
}

{
  "ok": true
}

{
  "error": "MISSING_FIELDS",
  "message": "yy, smt, organ_cd, serv_cd 필드가 모두 필요합니다."
}

{
  "aply_row": {
    "ORGAN_CD": "ORG001",
    "ORGAN_NM": "아산시자원봉사센터",
    "SERV_CD": "VS202501001",
    "SERV_NM": "노인복지관 급식 봉사",
    "SERV_DT": "20250315",
    "SERV_PLACE": "아산시 온양노인복지관 3층 식당",
    "SERV_TIME": "4",
    "APLY_DT": "20250308",
    "APLY_ST": "01",
    "APLY_ST_NM": "신청완료"
  }
}

{
  "ok": true
}

{
  "error": "MISSING_FIELDS",
  "message": "aply_row 누락"
}

GET /api/extracurricular/?yy=2025&smt=11&excr_div=A&keyword=AI&use_sust=0

{
  "yy": "2025",
  "smt": "11",
  "now": {
    "YY": "2025",
    "SMT": "11"
  },
  "categories": [
    { "EXCR_DIV": "T", "EXCR_DIV_NM": "전체" },
    { "EXCR_DIV": "A", "EXCR_DIV_NM": "취창업" },
    { "EXCR_DIV": "B", "EXCR_DIV_NM": "글로벌" },
    { "EXCR_DIV": "C", "EXCR_DIV_NM": "인성·봉사" },
    { "EXCR_DIV": "D", "EXCR_DIV_NM": "학술·연구" }
  ],
  "user_info": [
    {
      "DEPT_NM": "컴퓨터소프트웨어공학과",
      "GRADE": "3"
    }
  ],
  "open_list": [
    {
      "EXCR_SEQ": "20250001",
      "EXCR_NM": "취업역량 강화 특강 — 이력서 작성법과 면접 전략",
      "EXCR_DIV": "A",
      "EXCR_DIV_NM": "취창업",
      "OPEN_DT": "20250310",
      "CLOSE_DT": "20250320",
      "PROC_DT": "20250325",
      "PROC_PLACE": "산학협력관 201호",
      "SERV_TIME": "2",
      "MAX_CNT": "30",
      "APLY_CNT": "18",
      "APLY_YN": "N",
      "FILE_NO": "F20250001"
    },
    {
      "EXCR_SEQ": "20250002",
      "EXCR_NM": "AI 코딩 워크숍 — Python과 머신러닝 입문",
      "EXCR_DIV": "A",
      "EXCR_DIV_NM": "취창업",
      "OPEN_DT": "20250312",
      "CLOSE_DT": "20250322",
      "PROC_DT": "20250328",
      "PROC_PLACE": "공학관 E동 203호",
      "SERV_TIME": "3",
      "MAX_CNT": "25",
      "APLY_CNT": "25",
      "APLY_YN": "N",
      "FILE_NO": "F20250002"
    }
  ],
  "aply_list": [
    {
      "EXCR_SEQ": "20240055",
      "EXCR_NM": "글로벌 커뮤니케이션 리더십 캠프",
      "PROC_DT": "20241015",
      "APLY_DT": "20241001",
      "APLY_ST": "02",
      "APLY_ST_NM": "수료"
    }
  ]
}

{
  "row": {
    "EXCR_SEQ": "20250001",
    "EXCR_NM": "취업역량 강화 특강 — 이력서 작성법과 면접 전략",
    "EXCR_DIV": "A",
    "EXCR_DIV_NM": "취창업",
    "OPEN_DT": "20250310",
    "CLOSE_DT": "20250320",
    "PROC_DT": "20250325",
    "PROC_PLACE": "산학협력관 201호",
    "SERV_TIME": "2",
    "MAX_CNT": "30",
    "APLY_CNT": "18",
    "APLY_YN": "N",
    "FILE_NO": "F20250001"
  }
}

{
  "EXCR_SEQ": "20250001",
  "EXCR_NM": "취업역량 강화 특강 — 이력서 작성법과 면접 전략",
  "EXCR_DIV_NM": "취창업",
  "PROC_DT": "20250325",
  "PROC_PLACE": "산학협력관 201호",
  "PROC_TIME": "14:00 ~ 16:00",
  "SERV_TIME": "2",
  "MAX_CNT": "30",
  "APLY_CNT": "18",
  "INSTR_NM": "김지훈 (취업지원팀 선임연구원)",
  "CONT": "실제 인사담당자가 직접 전달하는 이력서 작성 노하우와 면접 전략을 다룹니다. 실습 위주로 진행되며, 개인 피드백 세션이 포함됩니다.",
  "APLY_STRT_DT": "20250310",
  "APLY_END_DT": "20250320",
  "FILE_NO": "F20250001",
  "APLY_YN": "N"
}

{
  "error": "MISSING_FIELDS",
  "message": "row 누락"
}

GET /api/extracurricular/attach/?file_no=F20250001

{
  "items": [
    {
      "FILE_NO": "F20250001",
      "FILE_SEQ": "1",
      "FILE_NM": "취업역량특강_안내문.pdf",
      "FILE_SIZE": "245760",
      "FILE_EXT": "pdf"
    },
    {
      "FILE_NO": "F20250001",
      "FILE_SEQ": "2",
      "FILE_NM": "이력서_작성양식.docx",
      "FILE_SIZE": "32768",
      "FILE_EXT": "docx"
    }
  ]
}

GET /api/extracurricular/leaflet/

{
  "items": [
    {
      "LFLT_SEQ": "1",
      "LFLT_NM": "2025학년도 1학기 비교과과정 안내 리플렛",
      "FILE_NO": "LF20250001",
      "REG_DT": "20250228"
    },
    {
      "LFLT_SEQ": "2",
      "LFLT_NM": "취창업 지원 프로그램 안내",
      "FILE_NO": "LF20250002",
      "REG_DT": "20250305"
    }
  ]
}

GET /api/extracurricular/download/?file_no=F20250001

Content-Type: application/octet-stream
Content-Disposition: attachment; filename="취업역량특강_안내문.pdf"

const res = await fetch('/api/extracurricular/download/?file_no=F20250001', {
  credentials: 'include',
})
const blob = await res.blob()
const filename = res.headers.get('Content-Disposition')?.split('filename=')[1] ?? 'download'
const url = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = url
a.download = decodeURIComponent(filename)
a.click()
URL.revokeObjectURL(url)

GET /api/service-learning/?yy=2025&smt=11&edu_div=U2520001

{
  "yy": "2025",
  "smt": "11",
  "now": { "YY": "2025", "SMT": "11" },
  "categories": [
    { "code": "U2520001", "name": "봉사학습교육" }
  ],
  "questions": [
    {
      "Q_NO": "1",
      "Q_NM": "이 봉사학습 프로그램에 대한 전반적인 만족도는 어떻습니까?",
      "Q_TYPE": "5",
      "OPTIONS": ["매우 불만족", "불만족", "보통", "만족", "매우 만족"]
    },
    {
      "Q_NO": "2",
      "Q_NM": "봉사학습 활동이 전공 역량 향상에 도움이 되었습니까?",
      "Q_TYPE": "5",
      "OPTIONS": ["전혀 아니다", "아니다", "보통", "그렇다", "매우 그렇다"]
    }
  ],
  "subjective": [
    {
      "Q_NO": "5",
      "Q_NM": "봉사학습 활동 중 가장 기억에 남는 경험과 느낀 점을 자유롭게 작성해주세요."
    }
  ],
  "lectures": [
    {
      "EDU_SEQ": "SL2025001",
      "EDU_NM": "지역사회 환경 개선 봉사학습",
      "PROF_NM": "박현수",
      "DEPT_NM": "사회복지학과",
      "PROC_DT": "20250405",
      "PROC_END_DT": "20250620",
      "PROC_PLACE": "아산시 온양3동 일원",
      "MAX_CNT": "20",
      "APLY_CNT": "15",
      "CREDIT": "1",
      "EDU_TIME": "30",
      "APLY_YN": "N",
      "FILE_NO": "SLF20250001"
    },
    {
      "EDU_SEQ": "SL2025002",
      "EDU_NM": "다문화 가정 학습 지원 봉사학습",
      "PROF_NM": "이수연",
      "DEPT_NM": "교육학과",
      "PROC_DT": "20250408",
      "PROC_END_DT": "20250625",
      "PROC_PLACE": "아산시 다문화가족지원센터",
      "MAX_CNT": "15",
      "APLY_CNT": "9",
      "CREDIT": "1",
      "EDU_TIME": "30",
      "APLY_YN": "N",
      "FILE_NO": "SLF20250002"
    }
  ],
  "aply_list": [
    {
      "EDU_SEQ": "SL2024010",
      "EDU_NM": "노인 디지털 역량 강화 봉사학습",
      "APLY_DT": "20240908",
      "COMP_YN": "Y",
      "COMP_DT": "20241122",
      "EVAL_YN": "N",
      "CREDIT": "1"
    }
  ],
  "user_info": [
    {
      "STD_NO": "20201234",
      "NM": "홍길동",
      "DEPT_NM": "컴퓨터소프트웨어공학과",
      "GRADE": "4"
    }
  ]
}

{
  "row": {
    "EDU_SEQ": "SL2025001",
    "EDU_NM": "지역사회 환경 개선 봉사학습",
    "PROF_NM": "박현수",
    "DEPT_NM": "사회복지학과",
    "PROC_DT": "20250405",
    "PROC_END_DT": "20250620",
    "PROC_PLACE": "아산시 온양3동 일원",
    "MAX_CNT": "20",
    "APLY_CNT": "15",
    "CREDIT": "1",
    "EDU_TIME": "30",
    "APLY_YN": "N",
    "FILE_NO": "SLF20250001"
  }
}

{
  "EDU_SEQ": "SL2025001",
  "EDU_NM": "지역사회 환경 개선 봉사학습",
  "PROF_NM": "박현수",
  "DEPT_NM": "사회복지학과",
  "PROC_DT": "20250405",
  "PROC_END_DT": "20250620",
  "PROC_PLACE": "아산시 온양3동 일원",
  "CREDIT": "1",
  "EDU_TIME": "30",
  "MAX_CNT": "20",
  "APLY_CNT": "15",
  "EDU_CONT": "아산시 온양3동 지역 내 생활쓰레기 무단투기 지역을 중심으로 환경정화 활동을 진행합니다. 월 2회, 총 6회 활동 예정이며, 수료 후 1학점이 부여됩니다.",
  "APLY_STRT_DT": "20250310",
  "APLY_END_DT": "20250331",
  "FILE_NO": "SLF20250001"
}

{
  "error": "MISSING_FIELDS",
  "message": "row 누락"
}

{
  "row": {
    "EDU_SEQ": "SL2025001",
    "EDU_NM": "지역사회 환경 개선 봉사학습",
    "PROF_NM": "박현수",
    "DEPT_NM": "사회복지학과",
    "PROC_DT": "20250405",
    "PROC_END_DT": "20250620",
    "PROC_PLACE": "아산시 온양3동 일원",
    "MAX_CNT": "20",
    "APLY_CNT": "15",
    "CREDIT": "1",
    "EDU_TIME": "30",
    "APLY_YN": "N",
    "FILE_NO": "SLF20250001"
  }
}

{
  "ok": true,
  "code": "0",
  "message": "신청이 완료되었습니다."
}

{
  "ok": false,
  "code": "E001",
  "message": "이미 신청된 봉사학습입니다."
}

{
  "error": "MISSING_FIELDS",
  "message": "row 누락"
}

{
  "row": {
    "EDU_SEQ": "SL2024010",
    "EDU_NM": "노인 디지털 역량 강화 봉사학습",
    "APLY_DT": "20240908",
    "COMP_YN": "N",
    "COMP_DT": "",
    "EVAL_YN": "N",
    "CREDIT": "1"
  }
}

{
  "ok": true,
  "code": "0",
  "message": "취소가 완료되었습니다."
}

{
  "error": "MISSING_FIELDS",
  "message": "row 누락"
}

{
  "row": {
    "EDU_SEQ": "SL2024010",
    "EDU_NM": "노인 디지털 역량 강화 봉사학습",
    "APLY_DT": "20240908",
    "COMP_YN": "Y",
    "COMP_DT": "20241122",
    "EVAL_YN": "N",
    "CREDIT": "1"
  },
  "form": {
    "1": "5",
    "2": "4",
    "5": "어르신들과 함께 스마트폰 사용법을 익히는 과정에서 세대 간 소통의 소중함을 깊이 느꼈습니다. 단순한 기술 전달을 넘어 진정한 나눔의 의미를 배울 수 있었습니다."
  }
}

{
  "ok": true,
  "code": "0",
  "message": "평가가 저장되었습니다."
}

{
  "error": "MISSING_FIELDS",
  "message": "row 누락"
}

GET /api/service-learning/attach/?file_no=SLF20250001

{
  "items": [
    {
      "FILE_NO": "SLF20250001",
      "FILE_SEQ": "1",
      "FILE_NM": "봉사학습_활동계획서.pdf",
      "FILE_SIZE": "512000",
      "FILE_EXT": "pdf"
    },
    {
      "FILE_NO": "SLF20250001",
      "FILE_SEQ": "2",
      "FILE_NM": "봉사학습_오리엔테이션_자료.pptx",
      "FILE_SIZE": "2097152",
      "FILE_EXT": "pptx"
    }
  ]
}

GET /api/service-learning/download/?file_no=SLF20250001

Content-Type: application/octet-stream
Content-Disposition: attachment; filename="봉사학습_활동계획서.pdf"

const res = await fetch('/api/service-learning/download/?file_no=SLF20250001', {
  credentials: 'include',
})
const blob = await res.blob()
const filename = res.headers.get('Content-Disposition')?.split('filename=')[1] ?? 'download'
const url = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = url
a.download = decodeURIComponent(filename)
a.click()
URL.revokeObjectURL(url)