[OPEN API] 1. OPEN API란 무엇인지 맛보기

[OPEN API] 1. OPEN API란 무엇인지 맛보기

---

안녕하세요. 언제나 휴일, 언휴예요.

많은 분들은 이미 Open API를 알고 이를 활용하는 다양한 응용이나 앱, 가젯 등을 만들어서 활용하고 있어요. 

여러분께서 Open API라는 것을 들어는 보았는데 이것이 어디에 쓰는 것인지 궁금하다면 적당한 게시글을 찾은 것이죠.

Open API는 말 그대로 개방형 API예요. 

API가 응용 프로그램을 개발할 때 사용하는 인터페이스라는 의미이므로 Open API는 프로그래밍에 사용할 수 있는 개방 상태의 인터페이스를 말하고 있어요. 

다음이나 구글, 네이버 등의 포털 사이트나 통계청, 기상청 등에서 수집한 자료를 응용 프로그래밍에 사용할 수 있게 제공하는 서비스예요.

자료를 수집하는 역할을 하는 많은 관공서나 단체에서는 전체 사회적 비용을 줄이기 위해 개발에 사용할 수 있는 Open API를 제공하고 있어요. 이번 게시글에서는 다음에서 제공하는 Open API를 통해 Open API가 무엇인지 맛보기만 하고 실제 프로그래밍에 활용하는 것은 이후에 소개할 거예요.

다음 Open API를 맛 보기 전에 통계청 Open API와 지도 API를 이용한 대학생 프로젝트 시연을 하나 소개하고 넘어갈게요. 

위 프로젝트는 원하는 지역의 인구나 연령, 수입, 학교 및 관공서 등의 정보를 통계청 Open API를 사용하여 얻어온 후에 이를 지도 API로 나타낸 곳에 Heat 분석 및 버퍼링 분석한 결과를 Overray하여 직관적으로 정보를 제공하는 솔루션입니다.

만약 개발자나 개발 회사가 직접 모든 지역의 인구나 연령, 수입, 학교 및 관공서 등의 상세 정보를 수집하여 프로젝트를 한다면 너무도 많은 비용이 들겠죠.

이러한 사회적 비용을 줄일 수 있게 포털 사이트나 관공서 등의 정보 수집 단체에서는 공공 이익을 위해 수집한 정보를 일정 수준에서 개방하는 서비스가 Open API예요.

이렇게 보여주고 말하는 것은 지금 나에게 아무런 도움을 주지 못한다구요?

그럼 이제 Open API를 맛보기를 해 보기로 해요. 앞에서도 말했지만 이번 게시글에서는 실제 프로그래밍까지는 연결하지 않을 것이며 단지 Open API가 무엇인지 맛보기만 할 거예요.

여기에서는 다음 Open API로 도서 검색을 하는 예를 들기로 할게요.

먼저 다음 포털에서 "다음 개발자 센터"로 검색하세요.

그리고 검색한 결과 중에 맨 위에 "Daum Developers" 하이퍼 링크를 클릭하세요.

다음 개발자 센터의 메인 화면을 만날 거예요. 대부분의 Open API를 사용하려면 검색 권한을 부여받아서 실제 검색에 전달하여 사용합니다. 그리고 이처럼 Open API를 사용할 수 있는 권한을 "Open API 키" 로 제공하는 곳이 많습니다.

다음 개발자 센터에서는 키를 발급받기 위해 콘솔 메뉴를 선택하세요.

다음 개발자 센터에서는 Open API를 만들 목적에 따라 키를 별도로 발급받아 사용할 수 있어요. 먼저 앱 만들기를 선택하세요. 여기에서 "앱" 이라고 하지만 실제 여러분은 웹 사이트나 응용 프로그래밍 등에서도 활용할 수 있습니다.

개발 목적에 맞게 적절한 앱 이름을 입력하시고 완료 버튼을 누르세요.

만약 웹 사이트에서 Open API를 활용할 것이면 수정하기를 입력하세요. 

그리고 앱 URL에 사용할 자신의 사이트 URL을 입력하세요..

API 키를 선택하세요.

그리고 사용할 플랫폼을 선택하세요. 아직 어떤 곳에 사용할 지 결정하지 못하였다면 모든 플랫폼을 선택하세요.

다음과 같은 화면이 보이면서 자신에게 발급한 API키를 확인할 수 있어요. 이 키는 다른 곳에서 사용하지 못하게 보안에 책임은 여러분에게 있습니다. 저도 검정색으로 가렸죠. ^^;;

절차가 복잡하다구요? 네. Open API는 처음 사용하기 위해 키를 발급받는 부분이 제일 복잡한 것 같아요. 하지만 이 작업은 한 번만 수행하는 것이니 너무 불평할 필요는 없어요. 그래도 불평이 생긴다면 과감하게 사용하지 않을 권리가 여러분에게 있으니 각자 알아서 판단하시길~

이제 키를 발급받았으니 다음에서 제공하는 검색 서비스를 활용해 보기로 해요. 서비스를 선택하세요.

그리고 API 목록 중에서 검색을 선택합시다. 여기에서는 제일 간단하다고 볼 수 있는 검색 API를 사용해 볼 거예요.

다양한 검색 기능을 제공하는 것을 볼 수 있는데 여기에서는 책 검색을 해 보기로 해요.

다음처럼 요청 주소가 나올 거예요. 이 부분을 복사하여 메모장에 붙여넣기 하세요.

그리고 요청 주소에 검색할 질의나 형식 등을 전달할 요청 변수가 있습니다. 이 부분은 쿼리 문자열로 전달할 부분입니다.

예를 들어 "C언어" 책을 검색하고자 한다면 "요청주소?...&q=C언어&..." 처럼 쿼리 문자열에 q파라미터의 값을 C언어로 설정하여 질의하는 것이죠. 쿼리 문자열에서는 사이트 주소와 요청 변수 사이에 ?로 구분하고 변수와 변수 사이는 &로 구분해요. 그리고 변수=값 형태로 자신이 원하는 파라미터에 값을 설정한답니다. 이 부분은 앞으로 계속 사용할 부분이예요. 

다음 개발자 센터는 친절하게 어떻게 질의를 하고 어떤 결과가 나오는지 설명을 잘 해 주고 있어요. apikey={apikey} 중에 = 뒤에 { } 부분을 여러분의 키를 전달하여 검색하라는 의미예요. 

만약 여러분의 키가 abc라면 "http://apis.daum.net/search/book?apikey=abc&q=다음카카오&output=json"처럼 입력하라는 것이죠.

그리고 밑에 나온 것은 결과 예제입니다.

저는 질의어를 "IT전문가로가는길", 출력 유형을 xml로 설정하여 브라우저 주소 창에 입력해 보았어요. 여러분께서도 발급받은 자신의 키와 검색 질의 및 출력 유형 등을 설정하여 브라우저 주소 창에 입력해 보세요.

이상으로 Open API가 무엇인지 맛보기를 해 보았어요.

여기에서는 맛보기만 했지만 이를 여러 종류의 프로그래밍에 활용하면 보다 알찬 프로그램을 만들 수 있겠죠.

앞으로 다양한 방법으로 Open API를 활용하여 프로그래밍하는 방법을 소개할게요.

그럼 모두 행복한 하루~

---

OPEN API를 활용한 프로그래밍 시작

[OPEN API] 2. C# 콘솔 응용 프로그램, 다음 Open API 책 검색

[OPEN API] 3. C# 콘솔 응용 프로그램, 다음 Open API 책 검색2

[OPEN API] 4. C# Windows Forms 응용 프로그램, 다음 Open API 책 검색3