정부와 공공기관이 보유한 데이터를 무료로 가져다 쓸 수 있는 공공데이터포털 API는 개인 프로젝트부터 실무까지 다양하게 활용돼요. 그런데 처음 접하면 회원가입만으로 끝나는 게 아니라 서비스별 신청과 승인 절차가 별도로 필요해서 헷갈리는 경우가 많아요. 실제 사용 절차를 단계별로 정리해봐요.
공공데이터포털 회원가입과 로그인
공공데이터 API를 쓰려면 먼저 공공데이터포털(data.go.kr)에 회원가입을 해야 해요. 개인, 사업자, 공공기관 등 회원 유형에 따라 가입 절차가 조금씩 다르며, 대부분의 오픈 API는 개인 회원 가입만으로도 이용할 수 있어요.
회원가입 시 이메일 인증을 거쳐야 하고, 가입이 완료되면 로그인 후 마이페이지에서 본인이 신청한 API 목록과 활용 현황을 확인할 수 있는 화면이 제공돼요. 이 마이페이지가 이후 API 키를 관리하는 핵심 화면이 돼요.
원하는 데이터 API 검색하고 활용신청하기
포털 상단 검색창에서 원하는 데이터를 검색하면 관련 오픈 API 목록이 나와요. 검색 결과에서 ‘오픈API’ 탭을 선택하면 API 형태로 제공되는 데이터만 걸러서 볼 수 있어요.
원하는 API를 찾았다면 상세 페이지에서 ‘활용신청’ 버튼을 눌러야 해요. 이 단계가 회원가입과 별개로 꼭 거쳐야 하는 절차예요. API마다 개발계정과 운영계정을 구분해서 신청받는 경우가 많은데, 처음 테스트할 때는 개발계정으로 신청하면 즉시 또는 빠르게 승인되는 경우가 대부분이에요.
활용신청 시에는 활용 목적, 서비스명, 상세 기능 설명 같은 항목을 입력해야 해요. 간단한 개인 프로젝트라도 이 항목들을 성실하게 작성하는 게 승인 처리에 도움이 돼요.
인증키 발급과 승인 대기
활용신청이 완료되면 API 호출에 사용할 인증키(서비스키)가 발급돼요. 개발계정은 보통 즉시 승인되어 바로 인증키를 확인할 수 있지만, 운영계정으로 전환하려면 기관 담당자의 승인 절차를 거쳐야 하는 경우도 있어요.
마이페이지의 ‘데이터활용’ 메뉴에서 신청한 API의 승인 상태와 인증키를 확인할 수 있어요. 인증키는 일반 인증키(Encoding)와 일반 인증키(Decoding) 두 가지 형태로 제공되는데, 사용하는 프로그래밍 언어나 요청 방식에 따라 어떤 형태를 써야 하는지가 달라져요.
요청 URL과 파라미터 구성하기
API를 실제로 호출하려면 각 API 상세 페이지에 나와 있는 ‘참고문서’나 ‘기술문서’를 확인해야 해요. 여기에는 기본 요청 주소(엔드포인트), 필수 요청변수, 응답 결과 항목이 정리돼 있어요.
- 서비스키(ServiceKey): 발급받은 인증키를 요청 파라미터에 포함시켜야 해요. 이 값이 없거나 잘못되면 호출 자체가 거부돼요.
- 페이지 관련 변수: 한 번에 몇 건을 가져올지(numOfRows), 몇 번째 페이지를 조회할지(pageNo) 지정하는 변수예요. 대량 데이터를 다룰 때 이 값을 조절해가며 수집해야 해요.
- 데이터 조회 조건 변수: 지역코드, 날짜, 검색어처럼 API마다 고유하게 요구하는 조회 조건 변수가 있어요. API별로 상세문서를 반드시 확인해야 정확한 데이터를 받을 수 있어요.
이런 변수들을 조합해 URL을 완성한 뒤 브라우저 주소창이나 API 테스트 도구에 입력하면 바로 응답 결과를 확인할 수 있어요. 포털 내에도 미리보기 기능이 있어서 코드를 작성하기 전에 요청 결과를 먼저 테스트해볼 수 있어요.
XML과 JSON, 응답 형식 선택
공공데이터 API는 대부분 XML과 JSON 두 가지 형식으로 응답을 제공해요. 요청 URL에 type 파라미터를 json으로 지정하면 JSON 형식으로, 지정하지 않거나 xml로 지정하면 XML 형식으로 데이터를 받을 수 있어요.
웹이나 앱 개발에서는 파싱이 간편한 JSON을 주로 사용하고, 기존 시스템과 연동하는 경우에는 XML 형식이 필요한 경우도 있어요. 어떤 형식이든 응답 구조는 상세문서에 예시로 제공되기 때문에, 실제 코드를 작성하기 전에 예시 응답값을 먼저 확인하는 게 시행착오를 줄이는 방법이에요.
자주 발생하는 오류와 대처법
가장 흔한 오류는 인증키 오류예요. Encoding 키와 Decoding 키를 혼동해서 사용하거나, URL 인코딩 과정에서 특수문자가 깨지는 경우 인증 실패가 발생해요. 이럴 때는 두 가지 키를 모두 바꿔가며 테스트해보는 게 빠른 해결법이에요.
활용신청 후에도 호출이 안 된다면 운영계정 승인이 아직 완료되지 않았을 가능성이 있어요. 마이페이지에서 승인 상태를 다시 확인하고, 승인이 지연된다면 해당 API를 제공하는 기관에 문의하는 절차를 거쳐야 해요.
공공데이터 API는 회원가입, 활용신청, 인증키 발급, 요청 파라미터 구성까지 여러 단계를 거쳐야 실제 사용이 가능해요. 처음에는 절차가 번거롭게 느껴질 수 있지만, 한 번 익혀두면 다른 공공데이터 API를 활용할 때도 동일한 흐름으로 적용할 수 있어서 훨씬 수월해져요.