[Network] Open API란?

Open API

 

정부에서 제공하는 공공데이터가 있다. 공공데이터에 쉽게 접근할 수 있도록 정부는 Open API의 형태로 공공데이터를 제공하고 있다. 공공데이터 포털에 접속해 원하는 키워드를 검색하면, 해당 키워드와 관련된 API를 확인할 수 있다.

 

이 API에는 "Open"이라는 키워드가 붙어 있다. 글자 그대로 누구에게나 열려있는 API이다.

• 그러나 "무제한으로 이용할 수 있다"라는 의미는 아니다.
• API마다 정해진 이용 수칙이 있고, 그 이용 수칙에 따라 제한사항(가격, 정보의 제한 등)이 있을 수 있다.

Open API를 간단하게 경험해 볼 수 있는 대표적인 페이지는, Open Weather Map이라는 웹 사이트에서 제공하는 날씨 API 이다. 이 웹사이트에서는 다음의 설명처럼 데이터를 제공한다. (기상청 API 등과의 비교, 차이점)

• 제한적이나마 무료로 날씨 API를 사용할 수 있다.
  • 프리 플랜에서는 기본적으로 분당 60번, 달마다 1백 번 호출이 가능하다.
• 데이터를 JSON 형태로 응답한다.

 

API Key

 

API를 이용하기 위해서는 API Key가 필요하다.

• API key는 서버의 문을 여는 열쇠이다.
• 서버를 운용하는 데에 비용이 발생하기 때문에 서버 입장에서 아무런 조건 없이 익명의 클라이언트에게 데이터를 제공할 의무는 없다. (가끔 API key가 필요하지 않은 경우도 있다.)
• API Key가 필요한 경우에는 로그인한 이용자에게 자원에 접근할 수 있는 권한을 API Key의 형태로 제공하고, 데이터를 요청할 때 API key를 같이 전달해야 원하는 응답을 받을 수 있다.

 

 

레퍼런스

구글, 마이크로소프트 같은 대기업도 REST API에 대한 가이드라인을 제시하고 있다. REST API의 모범적인 사례는 공신력 있는 가이드라인을 참고하자.

• 구글 REST API 작성 가이드라인
• 마이크로소프트 REST API 작성 가이드라인