국회도서관 자료검색 서비스

공공데이터 포털 에서 원하는 서비스 API 신청하기 #4

유니네 라이브러리 2024. 8. 2. 11:33

공공데이터 포털에서는 다양한 공공 API를 무료로 제공하고 있다.

이번 글에서는 공공데이터 포털에서 원하는 API를 검색하고 신청하는 과정을 소개한다.

 

1. 공공데이터 포털 회원가입 및 로그인

 

API를 사용하려면 먼저 공공데이터 포털 회원가입이 필요하다.

아래 사이트에서 회원가입을 진행한다.

 

🔗 공공데이터 포털: https://www.data.go.kr/

 

공공데이터 포털

국가에서 보유하고 있는 다양한 데이터를『공공데이터의 제공 및 이용 활성화에 관한 법률(제11956호)』에 따라 개방하여 국민들이 보다 쉽고 용이하게 공유•활용할 수 있도록 공공데이터(Datase

www.data.go.kr

 

공공데이터 포털은 정부 및 공공기관이 보유한 데이터를 개방하여,

국민 누구나 쉽게 데이터를 검색하고 활용할 수 있도록 지원하는 플랫폼이다.

공공데이터 포털

2. 원하는 API 검색하기

 

공공데이터 포털에서 제공하는 API는 다양한 분야에 걸쳐 있다.

필요한 API를 검색하는 방법은 다음과 같다.

 

📌 API 검색 방법

  1. 공공데이터 포털(data.go.kr)에 접속
  2. “API” 카테고리 선택
  3. 검색창에 원하는 키워드 입력
  4. 원하는 API 선택 후 상세 페이지 확인

이번 예제에서는 “국회도서관 자료검색 API”를 신청한다.

국회도서관 자료검색 서비스

 

3. API 서비스 선택

 

검색 결과에서 “국회도서관 자료검색 서비스” API를 선택한다.

 

📌 국회도서관 자료검색 API 정보

  • 서비스 유형: REST API
  • 데이터 포맷: XML
  • 기능: 국회도서관의 다양한 자료 검색 가능

API 명세는 Swagger 문서로 제공되며, 이를 통해 API의 세부 기능과 요청 형식을 확인할 수 있다.

국회도서관 자료검색 서비스 API 명세

4. API 활용 신청하기

 

API를 사용하려면 활용 신청을 해야 한다.

 

📌 API 신청 방법

  1. API 상세 페이지에서 “활용신청” 버튼 클릭
  2. 신청 양식 작성 및 제출
  3. 승인 완료 후 API 인증키 발급

개발용 계정은 하루 1,000건의 API 요청이 가능하며, 기본적인 개발 및 테스트에는 충분한 수준이다.

공공데이터 포털 API 신청 현황

5. API 인증키 발급 확인

 

신청이 승인되면, API 인증키를 확인할 수 있다.

 

📌 API 인증키 확인 방법

  1. 공공데이터 포털 로그인
  2. “마이페이지” → “오픈 API 이용정보” 이동
  3. 신청한 API 목록에서 발급된 인증키 확인

인증키는 API 호출 시 필수 파라미터로 사용된다.

(예: https://api.example.com?serviceKey=인증키)

공공데이터 포털 API 인증키

6. API 응답 데이터 미리 보기

 

신청한 API의 개발 계정 상세 보기 화면에서 API의 응답 데이터를 미리 확인할 수 있다.

 

📌 API 응답 데이터 확인 방법

  1. 신청한 API 상세 페이지 이동
  2. “API 테스트” 또는 “미리보기” 기능 사용
  3. XML 포맷으로 응답 데이터 확인

공공데이터 포털 API 응답데이터 미리보기

 

📌 국회도서관 자료검색 API의 XML 응답 예제

국회 도서관 자료검색 API의 XML 포맷 응답 데이터

7. 마무리

 

지금까지 공공데이터 포털에서 원하는 API를 신청하고, 인증키를 발급받는 과정을 알아봤다.

 

정리하면?

✔️ 공공데이터 포털 회원가입 및 로그인

✔️ 원하는 API 검색 및 활용 신청

✔️ API 인증키 발급 확인

✔️ API 응답 데이터 미리 보기

 

📌 다음 글에서는?

다음 글에서는 Django REST Framework를 사용하여 신청한 API를 호출하는 코드를 작성해 본다. 🚀

 

👉 [다음 글] Django REST Framework로 API 서버 구성하기