공공데이터포털 OpenAPI
대한민국 공공기관의 다양한 개방 데이터를 검색하고 신청하는 공식 포털
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- REST · JSON
- 인증
- 데이터셋별 서비스키 또는 별도 인증
- 비용
- 대부분 무료 · 데이터셋별 조건 확인
- 제공 상태
- 정식 포털 · API별 상태 상이
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
기관마다 신청 방식과 응답 구조가 달라 쓸 수 있는 데이터를 선별하기 어려운 초기 조사
- 어떤 어려움인가
- 공공기관 데이터를 서비스에 연결하는 개발·기획팀이 자주 마주치는 문제입니다. 구체적으로는 '기관마다 신청 방식과 응답 구조가 달라 쓸 수 있는 데이터를 선별하기 어려운 초기 조사' 상황입니다.
- 이렇게 해결합니다
- 공공데이터포털 OpenAPI 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '업무 질문, 대상 기관, 갱신 주기, 필수 필드'입니다. 필요한 필드만 골라 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 공공데이터포털 OpenAPI 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위업무 질문, 대상 기관, 갱신 주기, 필수 필드업무 조건
- 02 · 현재 자료공공데이터포털 OpenAPIAPI 요청: 입력 범위는 '업무 질문, 대상 기관, 갱신 주기, 필수 필드'입니다. 필요한 필드만 골라 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과신청 조건과 제공 형식이 비교된 데이터 소스 검토표
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
신청 조건과 제공 형식이 비교된 데이터 소스 검토표을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '기관마다 신청 방식과 응답 구조가 달라 쓸 수 있는 데이터를 선별하기 어려운 초기 조사' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- 공공데이터포털 OpenAPI 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '업무 질문, 대상 기관, 갱신 주기, 필수 필드'입니다. 필요한 필드만 골라 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표' 형태로 정리합니다. 다음 단계인 KOSIS OpenAPI에서는 '지표명·단위·기준 시점이 붙은 비교 데이터' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- 공공데이터포털 OpenAPI의 결과에는 원문 식별자와 처리 시각을 붙여 KOSIS OpenAPI로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '지표명·단위·기준 시점이 붙은 비교 데이터'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력업무 질문, 대상 기관, 갱신 주기, 필수 필드정리된 입력
- 02 · 현재 자료공공데이터포털 OpenAPI신청 조건과 제공 형식이 비교된 데이터 소스 검토표근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
기관마다 신청 방식과 응답 구조가 달라 쓸 수 있는 데이터를 선별하기 어려운 초기 조사를 반복 운영해야 할 때
- 어떤 어려움인가
- '기관마다 신청 방식과 응답 구조가 달라 쓸 수 있는 데이터를 선별하기 어려운 초기 조사' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- 공공데이터포털 OpenAPI 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '업무 질문, 대상 기관, 갱신 주기, 필수 필드'입니다. 필요한 필드만 골라 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표' 형태로 정리합니다. 보강은 KOSIS OpenAPI, 전달과 후속 처리는 OpenDART API로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 공공데이터포털 OpenAPI → KOSIS OpenAPI → OpenDART API 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '신청 조건과 제공 형식이 비교된 데이터 소스 검토표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력업무 질문, 대상 기관, 갱신 주기, 필수 필드과 작업 ID작업 요청
- 자동 처리02 · 현재 자료공공데이터포털 OpenAPI신청 조건과 제공 형식이 비교된 데이터 소스 검토표1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
첫 요청
curl "https://apis.data.go.kr/YOUR_SERVICE_PATH?serviceKey=YOUR_DATA_GO_KR_SERVICE_KEY&YOUR_REQUIRED_PARAMS"무엇이고 왜 필요한가
공공데이터포털 OpenAPI는 여러 공공기관이 제공하는 행정·교통·환경·산업 데이터를 서비스키로 호출하는 국가 데이터 진입점입니다. 같은 포털 안에서도 기관별 파라미터·응답 형식·갱신 주기가 달라 실제 운영에는 정규화 계층이 필요합니다.
할 수 있는 일
- 기관별 REST·SOAP OpenAPI를 찾아 활용 신청합니다.
- 교통·복지·산업·행정 데이터를 서비스에 연결합니다.
시작 전 확인
- 각 데이터셋의 활용 신청, 서비스키 인코딩 방식, 갱신 주기를 확인합니다.
- 인증·비용 조건은 데이터셋별 서비스키 또는 별도 인증, 대부분 무료 · 데이터셋별 조건 확인이며 제공 상태는 정식 포털 · API별 상태 상이입니다.
- 첫 요청은 공식 샘플과 테스트 자격으로 실행해 정상 응답·오류·호출 제한을 함께 확인합니다.
잘 맞는 경우
- 공공정보 기반 서비스, 리서치, 지역·행정 데이터 수집.
주의점
- API마다 제공 기관·스키마·품질·쿼터·라이선스가 달라 개별 상세를 검증합니다.
- API 키는 브라우저 코드나 공개 예제에 넣지 않고 서버 비밀값으로 보관하며, 호출 실패·재시도·사용량을 기록합니다.
함께 보면 좋은 자료
공공데이터 전체 보기OpenDART API
APIofficial상장사 공시·재무·지분 정보를 제공하는 금융감독원 공식 API
비용 무료 · 일일 요청 제한 적용
공공데이터등록 2026년 8월 6일KOSIS OpenAPI
APIofficial국가승인통계 표와 지표를 JSON·XML 등으로 제공하는 KOSIS 공식 API
비용 무료 · 호출 제한 적용
공공데이터등록 2026년 7월 8일기상청 API허브
APIofficial기상 관측·예보·특보·수치자료를 제공하는 기상청 공식 API 허브
비용 무료 · API별 호출 제한
공공데이터등록 2026년 6월 1일국토교통부 아파트 실거래가 API
APIofficial법정동·계약월 기준 아파트 매매 실거래 자료를 제공하는 국토교통부 공식 API
비용 무료 · 호출 제한 적용
공공데이터등록 2026년 4월 13일
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.