공공데이터포털 파일데이터와 오픈API 차이, 다운로드·인증키 신청 방법
공공데이터포털 파일데이터와 오픈API 차이, 다운로드·인증키 신청 방법
공공데이터포털에서 찾은 자료가 파일데이터인지 오픈API인지에 따라 이용방법이 달라집니다. 필요한 데이터의 형식과 갱신주기를 살핀 뒤 다운로드 또는 활용신청을 진행하는 순서를 소개합니다.
파일데이터는 파일을 받아 분석하는 방식, 오픈API는 인증키와 요청값으로 필요한 데이터를 조회하는 방식입니다.
먼저 파일데이터인지 오픈API인지 확인
공공데이터포털 검색결과에서 자료형이 파일데이터인지 오픈API인지 살펴보세요. 파일데이터는 CSV·엑셀 등의 파일을 일괄 내려받는 방식이고, 오픈API는 프로그램이 정해진 주소로 요청하여 데이터를 받는 방식입니다. 같은 기관 자료라도 제공 방식과 갱신주기가 다를 수 있습니다.
파일데이터를 찾는 순서
검색창에 원하는 지역·기관·항목을 넣은 뒤 파일데이터를 선택합니다. 상세페이지에서 제공기관, 수정일, 파일 형식, 설명과 이용조건을 확인하세요. 다운로드 버튼이 보이면 해당 안내에 따라 파일을 받을 수 있으며, 공개 파일은 로그인을 요구하지 않는 경우도 있습니다. 다운로드 전 확장자와 인코딩 관련 안내를 살펴보면 열기 오류를 줄일 수 있습니다.
파일 열기 전에 컬럼 설명 확인
CSV는 쉼표로 구분된 텍스트 형식이며, 엑셀에서 바로 열면 날짜·긴 숫자·앞자리 0이 뜻하지 않게 바뀔 수 있습니다. 중요한 식별번호가 포함된 데이터라면 문자형으로 읽어 들이는 방법을 확인하세요. 상세페이지의 데이터 설명서와 각 컬럼의 의미, 기준일, 단위가 분석 결과를 바꾸기도 합니다.
오픈API 활용신청이 필요한 이유
오픈API는 데이터별 상세페이지의 활용신청 절차를 통해 서비스 이용 권한과 인증키를 발급받도록 안내되는 경우가 많습니다. 회원가입 후 활용신청을 하고 승인상태와 개발계정 안내를 확인하세요. 데이터마다 즉시승인 또는 별도 심사, 신청 제한, 이용조건이 다를 수 있습니다.
인증키·요청주소를 구분하세요
오픈API 상세페이지에는 요청주소, 입력변수, 출력정보, 샘플 요청 예제가 제공될 수 있습니다. API 인증키는 호출할 때 사용하는 접근정보이므로 공개 문서나 게시판에 그대로 붙여 넣지 마세요. 일반 인증키와 URL 인코딩된 키를 혼동하면 인증 오류가 날 수 있어 공식 활용가이드를 확인해야 합니다.
호출 횟수와 응답 오류 살펴보기
활용신청 페이지의 트래픽 한도와 서비스 상태를 점검하세요. 요청이 실패하면 인증키 활성화 여부, 필수 파라미터, 날짜 형식, 요청 횟수 초과, 서비스 점검 여부를 차례로 확인합니다. HTTP 상태코드만 보지 말고 API 응답 본문에 들어 있는 결과코드도 함께 살펴보는 편이 정확합니다.
파일·API 데이터가 다르게 보인다면
파일데이터가 월 단위로 갱신되는 반면 API는 더 자주 바뀌는 사례가 있습니다. 제공일과 기준일, 업데이트 주기와 데이터 수집 범위를 비교한 뒤 사용할 자료를 선택하세요. 같은 이름의 자료라고 해도 데이터 단위나 제공기관이 다르면 일대일 비교가 불가능할 수 있습니다.
출처 표기와 이용조건 확인
자료를 보고서나 블로그에 사용하기 전에 공공데이터포털의 이용허락조건, 제공기관명, 기준일을 확인하고 명확히 출처를 남기세요. 데이터에 개인정보가 있는 경우에는 별도 법적 제한이 적용될 수 있습니다. 분석으로 만든 해석과 원자료가 직접 밝히는 사실을 혼동하지 않는 것이 중요합니다.
자주 묻는 질문
Q. 파일데이터는 무조건 로그인이 필요 없나요? A. 공개 파일은 별도 로그인 없이 받을 수 있는 경우가 있으나 데이터별 안내를 확인하세요.
Q. 오픈API는 파일을 받는 것과 무엇이 다른가요? A. 프로그램으로 요청해 응답 데이터를 받아 활용합니다.
Q. 인증키를 받았는데 오류가 납니다. A. 승인상태, 필수 입력값, 요청 한도, 인코딩을 확인하세요.
Q. 다운로드 자료를 그대로 공개해도 되나요? A. 개별 이용조건과 개인정보 포함 여부, 출처 표기 기준을 확인해야 합니다.
공식 출처
공공데이터포털 파일데이터 서비스 예시: https://www.data.go.kr/data/15076332/fileData.do?recommendDataYn=Y 공공데이터포털 오픈API 서비스 예시: https://www.data.go.kr/data/15077093/openapi.do?recommendDataYn=Y 공공데이터포털 공식 사이트: https://www.data.go.kr/