공공데이터 포털 API 활용법: 인증키 발급, 기상청 실황 조회 서버 만들기와 Vercel 배포 실습

핵심 메시지

• 공공데이터 포털의 오픈 API는 활용 신청과 승인을 거쳐 발급받는 인증키가 있어야 호출할 수 있다.
• 각 API에는 활용 가이드 문서가 따로 있어 호출 주소와 필요한 파라미터를 반드시 먼저 확인해야 한다.
• 기상청 실황 조회는 지역을 격자 좌표로 지정하고, 응답의 항목 코드로 기온·강수·바람을 구분한다.
• 서버 코드를 만들어 깃허브에 올린 뒤 Vercel로 배포하면 GPTs가 호출할 수 있는 주소가 생긴다.
• 항목 코드의 의미는 프롬프트에 적어주거나 가이드 문서를 함께 올려 모델이 이해하도록 하는 편이 좋다.

쉽게 이해하기

챗GPT의 GPTs에 외부 데이터를 붙이고 싶을 때 가장 현실적인 재료 중 하나가 공공데이터 포털이다. 영상은 포털에서 제공하는 오픈 API를 골라 서버로 감싼 뒤, 그 서버를 GPTs에 연결하는 과정을 두 편으로 나눠 설명한다. 이번 1편은 서버를 만들어 배포하는 데까지를 다루고, GPTs 연동은 2편으로 넘긴다. 예시로는 많은 사람이 쓸 만한 기상청 단기예보 조회 서비스를 골랐다.

출발점은 활용 신청이다. 포털에서 원하는 데이터를 찾아 활용 신청 버튼을 누르고, 로그인한 뒤 활용 목적을 간단히 적어 제출하면 된다. 승인이 나면 일반 인증키가 발급되는데, 이 값이 API를 호출할 때 비밀번호처럼 쓰인다. 신청 화면 옆에는 참고 문서가 함께 제공돼, 어떤 주소로 무엇을 보내야 하는지 알려주는 활용 가이드와 지역별 좌표표가 들어 있다.

가이드에서 확인해야 할 핵심은 두 가지다. 하나는 호출할 주소이고, 다른 하나는 함께 보내야 하는 요청 항목이다. 같은 기상청 서비스라도 실황 조회와 단기예보 조회는 주소 끝의 경로가 다르며, 요청에는 인증키와 결과 개수, 페이지 번호, 자료 형식, 기준 날짜와 시각, 그리고 예보 지점의 격자 좌표가 붙는다. 좌표는 동봉된 표에서 지역을 찾아 넣으면 되는데, 예를 들어 중구 명동은 가로 60, 세로 127로 지정한다.

응답은 항목 코드가 붙은 값들의 묶음으로 돌아온다. 기온을 뜻하는 코드만 골라 보면 해당 시각의 온도를 확인할 수 있고, 강수량이나 바람도 각각의 코드로 구분된다. 발표자는 나중에 GPTs와 연결할 때를 대비해 이 코드가 무슨 뜻인지 프롬프트에 적어주거나, 아예 활용 가이드 문서를 함께 올려 모델이 항목의 의미를 파악하도록 하는 방법을 권했다.

코드 작업은 새 폴더를 만들고 필요한 패키지를 설치하는 것으로 시작한다. 서버는 요청이 특정 경로로 들어오면 공공데이터 API를 대신 호출하고, 성공하면 받은 결과를 그대로 돌려주고 실패하면 오류 코드와 내용을 알려주도록 짰다. 로컬에서 정상 응답을 확인한 다음에는 깃허브 저장소를 새로 만들어 코드를 올리고, Vercel에 연결해 배포한다. 배포된 주소 뒤에 같은 경로를 붙여 호출했을 때 결과가 그대로 나오면 준비가 끝난 것이다.

주요 인사이트

• 공공데이터 API마다 요청 항목이 제각각이므로, 코드를 짜기 전에 활용 가이드를 먼저 읽는 것이 시행착오를 크게 줄인다.
• GPTs에 데이터를 붙일 때 API를 직접 부르게 하는 대신 서버를 한 겹 두면 인증키를 감추고 응답을 정리해 넘길 수 있다.
• 응답의 항목 코드는 사람이 보기엔 암호 같지만, 그 의미를 프롬프트나 첨부 문서로 알려주면 모델이 필요한 값만 골라낼 수 있다.
• 실황 조회는 최근 하루 정도의 자료만 조회되는 경우가 있어, 테스트는 오늘 날짜와 현재 시각 기준으로 하는 편이 안전하다.
• 테스트를 반복할 때는 실행 중인 터미널을 종료하고 새로 열어야 이전 프로세스가 남아 생기는 혼선을 피할 수 있다.

자주 묻는 질문

관련 AI 소식