공공데이터포털 API 사용법: 발급부터 호출까지

공공데이터포털(data.go.kr)에는 기상·교통·복지 등 수만 개의 공공 API가 무료로 공개돼 있습니다. 처음 쓰는 분을 위해 발급부터 호출까지 정리했습니다.

1. 회원가입 & 활용신청

data.go.kr에 회원가입한 뒤, 원하는 API 페이지에서 활용신청을 합니다. 대부분 개발계정은 자동 승인되며, 하루 요청 한도(보통 1,000~10,000회)가 부여됩니다.

2. 인증키(serviceKey) 확인

마이페이지 > 개발계정에서 일반 인증키(serviceKey)를 확인합니다. 이 키를 요청에 붙여 인증합니다. 키에는 Encoding/Decoding 두 형태가 있는데, URL에 그대로 넣을 땐 Encoding 키를 쓰는 경우가 많습니다.

3. 요청 주소 확인

각 API의 활용가이드(엔드포인트·파라미터)를 확인합니다. 요청 주소 예시가 함께 제공되며, serviceKey, pageNo, numOfRows 같은 파라미터를 붙입니다.

4. 호출과 응답

브라우저 주소창이나 코드로 요청하면 XML 또는 JSON으로 응답이 옵니다. rtnType=json 같은 파라미터로 형식을 지정할 수 있는 API도 있습니다.

자주 겪는 문제

결과가 안 나온다면 ①인증키 미승인/오타 ②필수 파라미터 누락(예: 지역코드) ③Encoding/Decoding 키 혼동을 먼저 확인하세요. 공공 API는 파라미터 설명이 부실한 경우가 많아, 활용가이드 문서를 꼼꼼히 봐야 합니다.

필요한 공공·국내 API를 키워드로 검색해 발급 페이지로 바로 이동해 보세요.