정부혜택 정보 (API 구현)

6 read
중소기업퇴직연금기금제도(푸른씨앗) 사업주 및 근로자 지원근로복지공단
서비스분야고용·창업
신청방법기타 온라인신청
신청기한수수료: 기금제도 가입 시 3년 면제/ 지원금: 해당 사업장이 기금제도 최초 가입한 날 부터 3년 이내
자세히 보기
송주법 지원사업 신청한국전력공사
서비스분야주거·자립
신청방법기타 온라인신청||방문신청
신청기한접수기관 별 상이
자세히 보기
복지할인 고효율가전 구매비용 지원사업한국전력공사
서비스분야생활안정
신청방법기타 온라인신청
신청기한상시신청
자세히 보기
주택용 에너지캐시백한국전력공사
서비스분야생활안정
신청방법기타 온라인신청||방문신청
신청기한상시신청
자세히 보기
소상공인 고효율 기기 지원한국전력공사
서비스분야생활안정
신청방법기타 온라인신청
신청기한상시신청
자세히 보기
식품매장 냉장고 문달기 지원한국전력공사
서비스분야생활안정
신청방법기타 온라인신청||방문신청||직접입력
신청기한상시신청
자세히 보기
청소년 미혼 한부모 자립지원 (우리원더패밀리)성평등가족부
서비스분야생활안정
신청방법기타 온라인신청
신청기한상시신청
자세히 보기
청소년부모 아동양육비 지원사업성평등가족부
서비스분야생활안정
신청방법방문신청
신청기한상시신청
자세히 보기
청년 문화예술패스문화체육관광부
서비스분야문화·환경
신청방법기타 온라인신청
신청기한2026.02.25.~2026.06.30.
자세히 보기
장애 체육인 교육지원금문화체육관광부
서비스분야문화·환경
신청방법방문신청
신청기한모집공고 시 제공
자세히 보기
장애 체육인 원로체육인 지원문화체육관광부
서비스분야문화·환경
신청방법방문신청
신청기한모집공고 시 제공
자세히 보기
노숙인 등 복지 지원보건복지부
서비스분야주거·자립
신청방법방문신청
신청기한상시신청
자세히 보기
로직 설명
  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();
    	}
    }