API

정부혜택 정보 (API 구현)

청록비

•2026-07-29•5 read

체육인 복지 지원(생활지원금)서울올림픽기념국민체육진흥공단

서비스분야생활안정

신청방법직접입력

신청기한국민체육진흥공단 공지사항 사업공고 내 신청시기 기재

장애인 건강보험료 경감국민건강보험공단

서비스분야보건·의료

신청방법신청불필요

신청기한상시신청

조산아 및 저체중 출생아 외래진료비 본인부담률 경감국민건강보험공단

서비스분야임신·출산

신청방법방문신청||직접입력

신청기한주민등록 이후 출생일로부터 최대 5년 4개월 이내

건강보험 산정특례국민건강보험공단

서비스분야보건·의료

신청방법방문신청||직접입력

신청기한상시신청

능력개발전담주치의 중소기업 훈련 참여 및 역량강화 지원한국산업인력공단

서비스분야고용·창업

신청방법기타 온라인신청

신청기한상시신청

산재근로자 대체인력지원금근로복지공단

서비스분야고용·창업

신청방법기타 온라인신청||방문신청||직접입력

신청기한상시신청

기초학습 지원성평등가족부

서비스분야보육·교육

신청방법방문신청

신청기한상시신청

저소득 다문화 자녀 교육활동비 지원성평등가족부

서비스분야생활안정

신청방법방문신청

신청기한해마다 다르며 대략적으로 5-7월 사이

다문화가족지원센터 이용성평등가족부

서비스분야보육·교육

신청방법방문신청

신청기한상시신청

경력보유여성 등 취업지원성평등가족부

서비스분야고용·창업

신청방법방문신청

신청기한접수기관 별 상이

고립·은둔 청소년 원스톱 패키지 지원성평등가족부

서비스분야보호·돌봄

신청방법방문신청

신청기한상시신청

가정폭력 피해자 보호시설 퇴소자 자립지원금성평등가족부

서비스분야주거·자립

신청방법방문신청||직접입력

신청기한상시신청

로직 설명

API URL - https://api.odcloud.kr/api/gov24/v3/serviceList
serviceKey - authkey ( 참고 : https://www.data.go.kr/data/15113968/openapi.do )
파라미터
- 등록일시(이상) : cond[등록일시::GTE]
- 등록일시(이하) : cond[등록일시::LTE]
- 소관기관유형 : cond[소관기관유형::LIKE]
- 기타 파라미터 : https://www.data.go.kr/data/15113968/openapi.do 참고

사용한 로직

/**
 * 정부혜택 서비스 관련 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();
	}
}