공공데이터포털(data.go.kr)은 정부와 공공기관이 보유한 데이터를 누구나 쓸 수 있게 공개하는 사이트예요. 날씨, 대기질, 사업자 등록 상태, 관광 정보 같은 데이터를 OpenAPI 형태로 받을 수 있어서 앱이나 웹 서비스, 데이터 분석 프로젝트에 많이 쓰여요. 사용하려면 회원가입, 활용신청, 인증키 확인이라는 과정을 거쳐야 해요.
이 글에서는 가입 방식, 활용신청 순서, 신청서에 적을 항목, 승인 소요 시간, 일반 인증키의 인코딩과 디코딩 구분, 호출 시 자주 겪는 문제를 순서대로 알려요.
회원가입과 회원 유형 선택
공공데이터포털에 접속해 우측 상단 로그인 버튼을 누르고 회원가입 링크로 들어가요. 개인회원, 기업회원, 기관회원 중에서 고를 수 있어요. 개인회원이 가입 절차가 간단하고 대부분의 API를 이용할 수 있어서 처음이라면 개인회원이 무난하다고 안내돼요.
가입할 때는 휴대폰 인증이나 아이핀 인증으로 본인 확인을 해요. 이어서 회원정보를 입력하고 이용약관에 동의하면 가입이 끝나요. 업무용 서비스로 대량 호출을 하거나 법인 명의로 신청해야 한다면 기업회원이나 기관회원을 고려해요.
활용신청 순서
데이터 목록에서 원하는 데이터를 검색하고 상세 페이지에서 활용신청 버튼을 눌러요. 로그인 후 마이페이지의 오픈API 개발계정 신청 메뉴로도 신청할 수 있어요. 데이터마다 제공 형태가 파일 데이터, 오픈API, 표준 데이터로 나뉘어서 API 형태인지 먼저 확인해요.
- 데이터 검색: 포털 검색창에 날씨, 사업자, 관광 같은 키워드를 넣어 찾아요. 제공 기관과 갱신 주기, 트래픽 한도를 확인해요.
- 활용신청 클릭: 상세 페이지의 오픈API 탭에서 활용신청을 눌러요. 이미 신청한 데이터는 내역에서 확인돼요.
- 개발계정 정보 입력: 신청자 정보(이름, 연락처, 이메일)와 개발 목적, 개발 언어, 개발 환경, 서비스 개요를 적어요.
- 약관 동의 후 제출: 라이선스 조건을 확인하고 신청서를 제출해요.
승인 소요 시간
활용신청 후에는 승인 절차가 있어요. 개발계정은 평일 기준 10분에서 3일 정도 걸려요. 자동 승인되는 서비스는 몇 분 안에 끝나고, 제공 기관이 심사하는 서비스는 더 오래 걸려요.
승인 상태는 마이페이지의 데이터 활용 메뉴에서 Open API 활용신청 현황으로 확인할 수 있어요. 승인 직후에도 서버에 인증키가 반영되는 데 시간이 걸려서, 바로 호출하면 오류가 날 수 있어요. 이럴 땐 한두 시간 뒤에 다시 시도해요. 주말에 신청하면 승인이 월요일로 밀릴 수 있으니 일정에 여유를 둬요.
일반 인증키 인코딩과 디코딩 구분
승인되면 개발계정 상세보기 페이지의 서비스정보에서 일반 인증키를 확인해요. 이 키는 인코딩(Encoding)과 디코딩(Decoding) 두 가지가 보여요. 둘은 같은 키를 다른 형식으로 보여주는 것이라, 어느 것을 쓰느냐가 호출 성공 여부를 가르는 경우가 많아요.
- 인코딩 키: URL에 포함해도 안전하도록 특수문자(+, /, = 등)를 변환한 형태예요. 주소창이나 URL 문자열에 직접 붙일 때 써요.
- 디코딩 키: 원래 문자 그대로의 키예요. 파이썬 requests의 params처럼 라이브러리가 URL 인코딩을 대신 해 주는 경우에 써요.
- 실수 사례: 인코딩 키를 params에 넣으면 라이브러리가 한 번 더 인코딩해서 인증 오류가 나요. 이중 인코딩이 가장 흔한 실수예요.
호출할 때 자주 겪는 문제
서비스키가 등록되지 않았다는 오류는 키가 아직 반영되지 않았거나 키를 잘못 넣었을 때 나와요. 키 형식을 바꿔 보고, 승인 상태가 완료인지 확인해요. 활용기간이 지났을 때도 같은 종류의 오류가 나서, 개발계정은 기간이 정해진 경우가 많으니 만료일을 챙겨요.
일일 트래픽 한도를 넘기면 호출이 거부돼요. 개발계정은 한도가 낮게 잡힌 경우가 있어서, 서비스를 운영하려면 운영계정 전환이나 한도 상향을 신청해야 해요. 응답 형식은 XML이 기본인 API가 많고 JSON을 지원하는 경우 파라미터로 형식을 지정해요. 서비스마다 요청 변수명이 다르므로 상세 페이지의 참고 문서를 꼭 읽어요.
정리하면 공공데이터 API는 회원가입, 활용신청, 승인 대기, 키 형식 구분 순으로 진행하고, 호출 오류는 대개 인코딩 키 문제거나 승인 반영 지연이에요.