정부혜택 정보 (API 구현)

13 read
사망·심신장애인 학자금대출 채무면제한국장학재단
서비스분야생활안정
신청방법기타 온라인신청||직접입력
신청기한상시신청
자세히 보기
사회적 배려계층 상환유예제도한국장학재단
서비스분야생활안정
신청방법기타 온라인신청
신청기한상시신청
자세히 보기
분할상환약정 조건변경 제도한국장학재단
서비스분야생활안정
신청방법기타 온라인신청
신청기한상시신청
자세히 보기
중소기업 재직자 분할상환약정제도한국장학재단
서비스분야생활안정
신청방법기타 온라인신청||방문신청
신청기한상시신청
자세히 보기
대학생 재능봉사 캠프한국장학재단
서비스분야보육·교육
신청방법직접입력
신청기한(하계캠프) 매년 5월 경, (동계캠프) 매년 11월 경
자세히 보기
강원랜드 객실나눔 및 힐링캠프 지원(주)강원랜드
서비스분야문화·환경
신청방법기타 온라인신청
신청기한복지넷 공지사항 참고
자세히 보기
중소기업 매출채권팩토링 지원중소벤처기업부
서비스분야고용·창업
신청방법기타 온라인신청
신청기한연중(예산 소진 시)
자세히 보기
중소기업 회사채 발행 지원(스케일업금융)중소벤처기업부
서비스분야고용·창업
신청방법직접입력
신청기한접수기관 별 상이
자세히 보기
글로벌 강소기업 1,000+ 프로젝트중소벤처기업부
서비스분야고용·창업
신청방법기타 온라인신청
신청기한2025.12.17~2026.01.09
자세히 보기
다중이용시설 실내환경 개선(국산목재)산림청
서비스분야농림축산어업
신청방법방문신청
신청기한사업연도 2월
자세히 보기
민간어린이집 실내환경 개선 지원(국산목재)산림청
서비스분야농림축산어업
신청방법방문신청
신청기한접수기관 별 상이
자세히 보기
청소년복지시설 퇴소청소년 자립지원수당성평등가족부
서비스분야주거·자립
신청방법방문신청
신청기한상시신청
자세히 보기
로직 설명
  1. API URL - https://api.odcloud.kr/api/gov24/v3/serviceList
  2. serviceKey - authkey ( 참고 : https://www.data.go.kr/data/15113968/openapi.do )
  3. 파라미터
    • 등록일시(이상) : cond[등록일시::GTE]
    • 등록일시(이하) : cond[등록일시::LTE]
    • 소관기관유형 : cond[소관기관유형::LIKE]
    • 기타 파라미터 : https://www.data.go.kr/data/15113968/openapi.do 참고
  4. 사용한 로직
    /**
     * 정부혜택 서비스 관련 API
     */
    export class PublicService {
    	/**
    	 * @param {string} authkey - data.go.kr 인증 키
    	 */
    	constructor(authkey) {
    		this.authkey = authkey;
    	}
    
    	async getList(opts) {
    
    		const { startDate, endDate, page=1, perPage=9, organ } = opts;
    
    		let conds = [];
    		
    		if(startDate) {
    			const strDate = DateUtil.format('yyyyMMdd', startDate);
    			conds.push(encodeURIComponent('cond[등록일시::GTE]')+`=${strDate}`);
    		} else {
    			const date = new Date();
    			date.setFullYear(date.getFullYear() - 1);
    			date.setMonth(0);
    			date.setDate(1);
    			
    			const strDate = DateUtil.format('yyyyMMdd', date);
    			conds.push(encodeURIComponent('cond[등록일시::GTE]')+`=${strDate}`);
    		}
    
    		if(endDate) {
    			const strDate = DateUtil.format('yyyyMMdd', endDate);
    			conds.push(encodeURIComponent('cond[등록일시::LTE]')+`=${strDate}`);
    		}
    
    		if(organ) {
    			conds.push(encodeURIComponent('cond[소관기관유형::LIKE]')+`=${organ}`);
    		}
    
    		const cond = conds.join('&');
    
    		const fetchUrl = 'https://api.odcloud.kr/api/gov24/v3/serviceList';
    		const url = `${fetchUrl}?serviceKey=${this.authkey}&page=${page}&perPage=${perPage}&${cond}`;
    
    		const res = await fetch(url, {
    			headers: {
    				'accept': 'application/json'
    			}
    		});
    		if (!res.ok) {
    			throw new Error('API 응답 실패');
    		}
    
    		return await res.json();
    	}
    }